You will see "Automatically created by Cortex" appear on a Team's page if the YAML references a GitHub team, but that GitHub team doesn't have a corresponding entry within Cortex. In this case, Cortex automatically creates an entry within the "teams catalog." This indicates that Cortex detected a service that was created and owned by a team that does not exist within Cortex.
To properly manage teams in Cortex, you have two main options for storing team entity YAML files in your GitHub repository:
- At the root directory of a repository in a cortex.yaml file
- In a structured subdirectory like .cortex/teams/, where individual team YAMLs (e.g., eng-team.yml, sre-team.yml) are stored in a dedicated teams folder
Note that teams with zero members may be treated as invalid by Cortex, which can affect how they appear in the system. To ensure a team is fully visible in Cortex, add at least one member to the team.