This article covers how Cortex assigns entities to catalogs automatically, plus how to create, edit, delete, and track changes to your own catalogs.
Adding an entity to a catalog
After Cortex imports or creates an entity, it automatically assigns the entity to a catalog based on that catalog’s entity type criteria. When you create a custom catalog, you can define its entity type criteria.Default catalogs come with preset entity type criteria:
The Services catalog contains service entities.
The Domains catalog contains domain entities.
The Teams catalog contains team entities.
The Infrastructure catalog contains any entity that isn’t type service, domain, or team.
Custom entity types belong to the Infrastructure catalog by default. To move a custom entity type to a different catalog, add it there directly.
Creating a custom catalog
Users with the Edit Catalogs permission can create, edit, or delete catalogsYou can create catalogs in the Cortex UI. For each catalog, you set the criteria that determine which entities belong to it. You can also define custom entity types to categorize the entities in your catalogs.Because catalogs aren’t defined by a YAML file, you can’t create them through a GitOps workflow.To create a new catalog:
From the main sidebar, expand Catalogs, then select All catalogs.
In the upper-right corner, click Create catalog.
On the Create new catalog page, do the following:
In the Details section:
Under Catalog name, enter a new name for the catalog (required).
Under Description, enter an overview of the catalog.
Under URL, enter a custom URL for the catalog. By default, the URL matches the catalog name. If the URL is updated, the latest URL will be activated immediately, and any previous URL navigates to the catalog list page as a fallback.
Example - For a catalog named “ML Models”, the auto-generated slug might be ml-models, resulting in a URL like: https://app.getcortexapp.com/admin/catalog/ml-models . You could customize the slug to something like machine-learning, giving you: https://app.getcortexapp.com/admin/catalog/machine-learning.
Under Display icon, select an icon to represent the catalog.
In the Catalog filter section:
From the Entity type tab, select one or more entity types to include their respective entities in the catalog. You can select entity types manually, or use advanced options like a CQL expression. Every entity that matches the criteria you set here is automatically included. Choose one filter type: entity type or relationship type.
Optionally, expand Advanced options to refine entity selection by applying additional filters for groups or a CQL expression. You can also skip other filters entirely and use a CQL expression alone to define the entity type selection.
From the Relationship type tab, select a relationship type to filter which entities appear on the catalog page.
By default, Draft is toggled on. If you’re ready to publish your changes, toggle it off.
Click Create.
New catalogs are found under Catalogs > All catalogs, automatically populated with entities that match your criteria. Catalogs with a relationship type filter display as a hierarchy.
Editing a catalog
Users with the Edit Catalogs permission can edit a catalog’s name, description, URL, display icon, and filter type.
From the main sidebar, expand Catalogs, then select the catalog you want to edit.
In the upper-right corner, click Edit catalog. The Edit catalog page opens.
Optionally, toggle on Draft to save your changes without publishing them.
When you’re ready to publish, toggle off Draft, then click Save.
Click Save.
Deleting a catalog
Users with the Edit Catalogs permission can delete a catalog.
You should only delete a catalog if you’re absolutely sure it’s no longer needed. Deleting a catalog does NOT delete the entities in that catalog.
From the main sidebar, expand Catalogs, then select the catalog you want to delete.
In the upper-right corner, click overview menu icon.
Select Delete catalog. The Delete catalog window opens.
Click Delete.
Tracking catalog changes
Use the audit log to track changes made to any of your catalogs. Catalog updates are listed as CATALOG in the Object type column. The Action type column indicates whether a catalog was created, deleted, or updated.
Last modified on September 9, 2026
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Cortex","colors":{"primary":"#653EE8","light":"#9378EF","dark":"#5132BA"},"logo":{"light":"https://mintcdn.com/cortex-290c0c42/JcmXgfdiEzZzqS2M/logo/cortex-light.svg?fit=max\u0026auto=format\u0026n=JcmXgfdiEzZzqS2M\u0026q=85\u0026s=3d32dd91336a0de9463a57e04f9b8bb3","dark":"https://mintcdn.com/cortex-290c0c42/JcmXgfdiEzZzqS2M/logo/cortex-dark.svg?fit=max\u0026auto=format\u0026n=JcmXgfdiEzZzqS2M\u0026q=85\u0026s=e664b364295c3625385d56e02110b4a7"},"favicon":{"light":"https://mintcdn.com/cortex-290c0c42/09VjkT_e7zMKfZOT/images/favicon.png?fit=max\u0026auto=format\u0026n=09VjkT_e7zMKfZOT\u0026q=85\u0026s=1689c84dea2d7ff7c17603f1d27163ae","dark":"https://mintcdn.com/cortex-290c0c42/09VjkT_e7zMKfZOT/images/favicon.png?fit=max\u0026auto=format\u0026n=09VjkT_e7zMKfZOT\u0026q=85\u0026s=1689c84dea2d7ff7c17603f1d27163ae"},"api":{"playground":{"display":"interactive"},"examples":{"prefill":true}},"appearance":{"default":"system"},"background":{"decoration":"gradient"},"navbar":{"links":[{"icon":"/images/us-flag.png","href":"https://app.getcortexapp.com/","label":"US"},{"icon":"/images/eu-flag.png","href":"https://app.eu.cortex.io/","label":"EU"}],"primary":{"type":"button","label":"Get a Demo","href":"https://www.cortex.io/demo"}},"footer":{"socials":{"github":"https://github.com/cortexapps","linkedin":"https://www.linkedin.com/company/cortexapp","youtube":"https://www.youtube.com/@cortex611","x":"https://twitter.com/GetCortexApp"},"links":[{"header":"Cortex","items":[{"label":"Cortex website","href":"https://cortex.io"},{"label":"Product log in (US)","href":"https://app.getcortexapp.com/login"},{"label":"Product log in (EU)","href":"https://app.eu.cortex.io/login"},{"label":"Privacy Policy","href":"https://www.cortex.io/legal/privacy-policy"},{"label":"Security Policy","href":"https://www.cortex.io/legal/security-policy"},{"label":"Terms of Service","href":"https://www.cortex.io/legal/terms-of-service"},{"label":"Status Page","href":"https://status.cortex.io/"}]},{"header":"Resources","items":[{"label":"Cortex Academy","href":"https://academy.cortex.io/"},{"label":"Blog","href":"https://www.cortex.io/blog"},{"label":"Engineering Blog","href":"https://builders.cortex.io/"},{"label":"Braintrust","href":"https://www.braintrust.cortex.io/"},{"label":"Contact Support","href":"https://support.cortex.io/"}]}]},"fonts":{"heading":{"family":"Inter"},"body":{"family":"Inter"}},"icons":{"library":"fontawesome"},"styling":{"eyebrows":"breadcrumbs","latex":false},"contextual":{"options":["copy","view","chatgpt","claude","download-pdf"],"display":"header"},"interaction":{"drilldown":true},"metadata":{"timestamp":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cortex-290c0c42","hasAudioNarration":false,"actualSubdomain":"cortex-290c0c42","customDomains":["docs.cortex.io"],"gitSource":{"type":"github","owner":"cortexapps","repo":"brainpower","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b00c5076fc2c7eacebff199","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":577},{"language":"default","tag":"REST API operations","count":576},{"language":"default","tag":"Integrations","count":427},{"language":"default","tag":"Product Docs","count":188},{"language":"default","tag":"Connect data","count":100},{"language":"default","tag":"Cookbooks","count":42},{"language":"default","tag":"Product areas","count":41},{"language":"default","tag":"Workflows","count":41},{"language":"default","tag":"Configure","count":28},{"language":"default","tag":"Entities overview","count":28}],"searchSettings":{"showContentSnippets":true}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":true}},"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":":where(img[src^=\"/images/\"]){display:block;margin-left:auto;margin-right:auto;max-width:100%;height:auto}#navbar li.navbar-link>a{background-color:rgb(3 7 18 / 0.06)}#navbar li.navbar-link>a:hover{background-color:rgb(3 7 18 / 0.12)}html.dark #navbar li.navbar-link>a{background-color:rgb(255 255 255 / 0.07)}html.dark #navbar li.navbar-link>a:hover{background-color:rgb(255 255 255 / 0.14)}#content-area .mdx-content{--tw-prose-links: #7458DB;--tw-prose-invert-links: #C0AFFF}html.dark #content-area .mdx-content :where(a):not(:where([class~=\"not-prose\"],[class~=\"not-prose\"] *)){color:#C0AFFF}.product-tab{background-color:#F3F4F6!important;color:#000!important}.product-tab[data-active=\"true\"]{background-color:#E6E7E9!important}html.dark .product-tab{background-color:rgb(255 255 255 / 0.1)!important;color:#fff!important}html.dark .product-tab[data-active=\"true\"]{background-color:#653EE8!important}.product-item[data-active=\"true\"]{background-color:#E6E7E9}html.dark .product-item[data-active=\"true\"]{background-color:rgb(255 255 255 / 0.05)}.product-item-arrow{opacity:0}.product-item-arrow svg{width:14px!important;height:14px!important;max-width:14px;max-height:14px;flex-shrink:0}.product-item-arrow[data-active=\"true\"]{opacity:1}#kapa-search-ask-row{display:flex;align-items:center;gap:0.5rem;margin:0 0.375rem 0.375rem;padding:0.625rem 0.75rem;border-top:1px solid rgb(229 231 235);background:transparent;font-size:0.875rem;font-weight:500;color:rgb(3 7 18);text-align:left;cursor:pointer}#kapa-search-ask-row[hidden]{display:none}#kapa-search-ask-row:hover{background:rgb(0 0 0 / 0.03)}#kapa-search-ask-row svg{width:1rem;height:1rem;flex-shrink:0;color:rgb(var(--primary))}#kapa-search-ask-row .kapa-search-ask-label{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}#kapa-search-ask-row kbd{padding:0 0.3rem;border:1px solid rgb(229 231 235);border-radius:0.25rem;font-family:inherit;font-size:0.75rem;color:rgb(107 114 128)}.dark #kapa-search-ask-row{border-top-color:rgb(255 255 255 / 0.1);color:#fff}.dark #kapa-search-ask-row:hover{background:rgb(255 255 255 / 0.05)}.dark #kapa-search-ask-row svg{color:rgb(var(--primary-light))}.dark #kapa-search-ask-row kbd{border-color:rgb(255 255 255 / 0.1);color:rgb(156 163 175)}#assistant-entry,#assistant-entry-mobile{display:none!important}#kapa-ask-button{display:none;flex:none;align-items:center;gap:0.375rem;height:2.25rem;margin-left:0.5rem;padding:0 0.875rem 0 0.75rem;border-radius:9999px;background:rgb(3 7 18 / 0.03);font-size:0.875rem;font-weight:500;color:rgb(55 65 81);cursor:pointer}@media (min-width: 1024px){#kapa-ask-button{display:flex}}#kapa-ask-button:hover{background:rgb(3 7 18 / 0.1)}#kapa-ask-button svg{width:1rem;height:1rem;color:rgb(var(--primary))}html.dark #kapa-ask-button{background:rgb(255 255 255 / 0.03);color:rgb(209 213 219)}html.dark #kapa-ask-button:hover{background:rgb(255 255 255 / 0.1)}html.dark #kapa-ask-button svg{color:rgb(var(--primary-light))}"},{"filePath":"status-tags.css","content":".nav-tag-pill[data-status]{background-color:var(--status-tag-color)!important;border-color:var(--status-tag-color)!important}.nav-tag-pill[data-status],.nav-tag-pill[data-status] .nav-tag-pill-text{color:#FFFFFF!important}.nav-tag-pill[data-status=\"research-preview\"]{--status-tag-color: #7B2D6B}.nav-tag-pill[data-status=\"public-beta\"]{--status-tag-color: #1D4ED8}.nav-tag-pill[data-status=\"private-beta\"]{--status-tag-color: #8C1D3A}.nav-tag-pill[data-status]{white-space:nowrap;flex-shrink:0}"},{"filePath":"changelog-dates.css","content":"html[data-changelog-page] #changelog-filters{height:100%;min-height:0}html[data-changelog-page] #changelog-filters>#changelog-filters{display:flex;flex-direction:column;height:auto;max-height:100%;overflow:hidden}html[data-changelog-page] #changelog-filters>#changelog-filters>*{flex-shrink:0}#changelog-dates{flex:1 1 auto!important;flex-shrink:1!important;min-height:0;overflow-y:auto;overscroll-behavior:contain;padding:0.5rem 0.25rem 1.5rem 0}#changelog-dates [hidden]{display:none!important}#changelog-dates .changelog-dates-toggle{display:flex;text-decoration:none;align-items:center;justify-content:space-between;width:100%;padding:0.375rem 0;font-weight:500;color:rgb(55 65 81);cursor:pointer}#changelog-dates .changelog-dates-toggle svg{width:0.875rem;height:0.875rem;transition:transform 150ms ease}#changelog-dates .changelog-dates-year[data-open] .changelog-dates-toggle svg{transform:rotate(90deg)}#changelog-dates .changelog-dates-list{display:none;list-style:none;margin:0.25rem 0 0.5rem;padding:0}#changelog-dates .changelog-dates-year[data-open] .changelog-dates-list{display:block}#changelog-dates .changelog-dates-list li{margin:0;padding:0}#changelog-dates .changelog-dates-list a{display:block;padding:0.25rem 0 0.25rem 1rem;border-left:1px solid rgb(3 7 18 / 0.05);color:rgb(75 85 99);text-decoration:none}#changelog-dates .changelog-dates-toggle:hover,#changelog-dates .changelog-dates-list a:hover{color:rgb(17 24 39)}#changelog-dates .changelog-dates-list a:hover{border-left-color:rgb(3 7 18 / 0.2)}#changelog-dates .changelog-dates-list li[data-active] a{color:rgb(var(--primary));border-left-color:rgb(var(--primary));font-weight:500}html.dark #changelog-dates .changelog-dates-toggle{color:rgb(209 213 219)}html.dark #changelog-dates .changelog-dates-list a{color:rgb(156 163 175);border-left-color:rgb(255 255 255 / 0.1)}html.dark #changelog-dates .changelog-dates-toggle:hover,html.dark #changelog-dates .changelog-dates-list a:hover{color:rgb(243 244 246)}html.dark #changelog-dates .changelog-dates-list a:hover{border-left-color:rgb(255 255 255 / 0.2)}html.dark #changelog-dates .changelog-dates-list li[data-active] a{color:rgb(var(--primary-light));border-left-color:rgb(var(--primary-light))}.update-container[data-untagged-hidden],h2[hidden]{display:none!important}"}]}
{"page":{"pagePath":"ingesting-data-into-cortex/catalogs/managing-catalogs","slug":"/ingesting-data-into-cortex/catalogs/managing-catalogs","pageMetadata":{"title":"Managing catalogs","description":null,"href":"/ingesting-data-into-cortex/catalogs/managing-catalogs"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`This article covers how Cortex assigns entities to catalogs automatically, plus how to create, edit, delete, and track changes to your own catalogs.`}),`\n`,_jsx(Heading,{level:`2`,id:`adding-an-entity-to-a-catalog`,children:`Adding an entity to a catalog`}),`\n`,_jsxs(_components.p,{children:[`After Cortex imports or creates an entity, it automatically assigns the entity to a catalog based on that catalog’s entity type criteria. When you `,_jsx(_components.a,{href:`/ingesting-data-into-cortex/catalogs/managing-catalogs#creating-a-custom-catalog`,children:`create a custom catalog`}),`, you can define its entity type criteria.`]}),`\n`,_jsx(_components.p,{children:`Default catalogs come with preset entity type criteria:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`The `,_jsx(_components.strong,{children:`Services`}),` catalog contains `,_jsx(_components.code,{children:`service`}),` entities.`]}),`\n`,_jsxs(_components.li,{children:[`The `,_jsx(_components.strong,{children:`Domains`}),` catalog contains `,_jsx(_components.code,{children:`domain`}),` entities.`]}),`\n`,_jsxs(_components.li,{children:[`The `,_jsx(_components.strong,{children:`Teams`}),` catalog contains `,_jsx(_components.code,{children:`team`}),` entities.`]}),`\n`,_jsxs(_components.li,{children:[`The `,_jsx(_components.strong,{children:`Infrastructure`}),` catalog contains any entity that isn’t type `,_jsx(_components.code,{children:`service`}),`, `,_jsx(_components.code,{children:`domain`}),`, or `,_jsx(_components.code,{children:`team`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/ingesting-data-into-cortex/entities-overview/entities/adding-entities/entity-types`,children:`Custom entity types`}),` belong to the `,_jsx(_components.strong,{children:`Infrastructure`}),` catalog by default. To move a custom entity type to a different catalog, add it there directly.`]}),`\n`,_jsx(Heading,{level:`2`,id:`creating-a-custom-catalog`,children:`Creating a custom catalog`}),`\n`,_jsxs(_components.p,{children:[`Users with the `,_jsx(_components.code,{children:`Edit Catalogs`}),` permission can create, edit, or delete catalogs`]}),`\n`,_jsx(_components.p,{children:`You can create catalogs in the Cortex UI. For each catalog, you set the criteria that determine which entities belong to it. You can also define custom entity types to categorize the entities in your catalogs.`}),`\n`,_jsx(_components.p,{children:`Because catalogs aren’t defined by a YAML file, you can’t create them through a GitOps workflow.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`To create a new catalog`}),`:`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`From the main sidebar, expand `,_jsx(_components.strong,{children:`Catalogs`}),`, then select `,_jsx(_components.strong,{children:`All catalogs`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`In the upper-right corner, click `,_jsx(_components.strong,{children:`Create catalog`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`On the `,_jsx(_components.strong,{children:`Create new catalog`}),` page, do the following:`,`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`In the `,_jsx(_components.strong,{children:`Details`}),` section:`,`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Under `,_jsx(_components.strong,{children:`Catalog name`}),`, enter a new name for the catalog (required).`]}),`\n`,_jsxs(_components.li,{children:[`Under D`,_jsx(_components.strong,{children:`escription`}),`, enter an overview of the catalog.`]}),`\n`,_jsxs(_components.li,{children:[`Under `,_jsx(_components.strong,{children:`URL`}),`, enter a custom URL for the catalog. By default, the URL matches the catalog name. If the URL is updated, the latest URL will be activated immediately, and any previous URL navigates to the catalog list page as a fallback.`,`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Example`}),` - For a catalog named “ML Models”, the auto-generated slug might be `,_jsx(_components.code,{children:`ml-models`}),`, resulting in a URL like: `,_jsx(_components.code,{children:`https://app.getcortexapp.com/admin/catalog/ml-models`}),` . You could customize the slug to something like `,_jsx(_components.code,{children:`machine-learning`}),`, giving you: `,_jsx(_components.code,{children:`https://app.getcortexapp.com/admin/catalog/machine-learning`}),`.`]}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`Under `,_jsx(_components.strong,{children:`Display icon`}),`, select an icon to represent the catalog.`]}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`In the `,_jsx(_components.strong,{children:`Catalog filter`}),` section:`,`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`From the `,_jsx(_components.strong,{children:`Entity type`}),` tab, select one or more entity types to include their respective entities in the catalog. You can select entity types manually, or use advanced options like a `,_jsx(_components.code,{children:`CQL`}),` expression. Every entity that matches the criteria you set here is automatically included. Choose one filter type: entity type or relationship type.`,`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Optionally, expand `,_jsx(_components.strong,{children:`Advanced options`}),` to refine entity selection by applying additional filters for groups or a `,_jsx(_components.code,{children:`CQL`}),` expression. You can also skip other filters entirely and use a `,_jsx(_components.code,{children:`CQL`}),` expression alone to define the entity type selection.`]}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`From the `,_jsx(_components.strong,{children:`Relationship type`}),` tab, select a relationship type to filter which entities appear on the catalog page.`]}),`\n`]}),`\n`]}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`By default, `,_jsx(_components.strong,{children:`Draft`}),` is toggled on. If you’re ready to publish your changes, toggle it off.`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Create`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`New catalogs are found under `,_jsx(_components.strong,{children:`Catalogs > All catalogs`}),`, automatically populated with entities that match your criteria. Catalogs with a relationship type filter display as a hierarchy.`]}),`\n`,_jsx(Heading,{level:`2`,id:`editing-a-catalog`,children:`Editing a catalog`}),`\n`,_jsxs(_components.p,{children:[`Users with the `,_jsx(_components.code,{children:`Edit Catalogs`}),` permission can edit a catalog’s name, description, URL, display icon, and filter type.`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`From the main sidebar, expand `,_jsx(_components.strong,{children:`Catalogs`}),`, then select the catalog you want to edit.`]}),`\n`,_jsxs(_components.li,{children:[`In the upper-right corner, click `,_jsx(_components.strong,{children:`Edit catalog`}),`. The `,_jsx(_components.strong,{children:`Edit catalog`}),` page opens.`]}),`\n`,_jsxs(_components.li,{children:[`Refer to step 3 in `,_jsx(_components.a,{href:`/ingesting-data-into-cortex/catalogs/managing-catalogs#creating-a-custom-catalog`,children:`Creating a custom catalog`}),` for detailed information.`]}),`\n`,_jsxs(_components.li,{children:[`Optionally, toggle on `,_jsx(_components.strong,{children:`Draft`}),` to save your changes without publishing them.`,`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`When you’re ready to publish, toggle off `,_jsx(_components.strong,{children:`Draft`}),`, then click `,_jsx(_components.strong,{children:`Save`}),`.`]}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Save`}),`.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`deleting-a-catalog`,children:`Deleting a catalog`}),`\n`,_jsxs(_components.p,{children:[`Users with the `,_jsx(_components.code,{children:`Edit Catalogs`}),` permission can delete a catalog.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`You should only delete a catalog if you’re absolutely sure it’s no longer needed. Deleting a catalog does NOT delete the entities in that catalog.`})}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`From the main sidebar, expand `,_jsx(_components.strong,{children:`Catalogs`}),`, then select the catalog you want to delete.`]}),`\n`,_jsxs(_components.li,{children:[`In the upper-right corner, click `,_jsx(_components.strong,{children:`overview menu icon`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Select `,_jsx(_components.strong,{children:`Delete catalog`}),`. The `,_jsx(_components.strong,{children:`Delete catalog`}),` window opens.`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Delete`}),`.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`tracking-catalog-changes`,children:`Tracking catalog changes`}),`\n`,_jsxs(_components.p,{children:[`Use the `,_jsx(_components.a,{href:`/configure/settings/audit-logs`,children:`audit log`}),` to track changes made to any of your catalogs. Catalog updates are listed as `,_jsx(_components.code,{children:`CATALOG`}),` in the `,_jsx(_components.strong,{children:`Object type`}),` column. The `,_jsx(_components.strong,{children:`Action type`}),` column indicates whether a catalog was created, deleted, or updated.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Managing catalogs","description":null,"href":"/ingesting-data-into-cortex/catalogs/managing-catalogs"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Adding an entity to a catalog","slug":"adding-an-entity-to-a-catalog","depth":2,"children":[]},{"title":"Creating a custom catalog","slug":"creating-a-custom-catalog","depth":2,"children":[]},{"title":"Editing a catalog","slug":"editing-a-catalog","depth":2,"children":[]},{"title":"Deleting a catalog","slug":"deleting-a-catalog","depth":2,"children":[]},{"title":"Tracking catalog changes","slug":"tracking-catalog-changes","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/cortex-290c0c42/ed8d91d3153959c2/kapa.js","/_mintlify/custom/cortex-290c0c42/36b87f2caabcf780/status-tags.js","/_mintlify/custom/cortex-290c0c42/cc8557fef10c63cd/changelog-dates.js"],"subdomain":"cortex-290c0c42","siteName":"Cortex","title":"Managing catalogs - Cortex","relatedPagesConfig":{"enabled":true,"limit":3,"mode":"automatic"},"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-10T23:58:33.753Z","gitLastModified":"2026-09-09T13:38:06.000Z","originalFileLocation":"ingesting-data-into-cortex/catalogs/managing-catalogs.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Cortex\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cortex-290c0c42/GsIUSGAJ7s7HMHgE/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/cortex-290c0c42/GsIUSGAJ7s7HMHgE/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cortex-290c0c42/GsIUSGAJ7s7HMHgE/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cortex-290c0c42/GsIUSGAJ7s7HMHgE/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cortex-290c0c42/GsIUSGAJ7s7HMHgE/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cortex-290c0c42/GsIUSGAJ7s7HMHgE/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cortex-290c0c42/GsIUSGAJ7s7HMHgE/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cortex-290c0c42/GsIUSGAJ7s7HMHgE/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cortex-290c0c42/GsIUSGAJ7s7HMHgE/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Managing catalogs - Cortex\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cortex\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cortex.io/ingesting-data-into-cortex/catalogs/managing-catalogs\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cortex-290c0c42.mintlify.site/_mintlify/api/og/v2?division=Catalogs+overview\u0026amp;title=Managing+catalogs\u0026amp;theme=99c32ff148ebb22d9370f9e9\u0026amp;signature=1a7ab4a089a7e1422cf1e4794c2c3af798229d4931cf76e18a8ffa2a7009f853\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Managing catalogs - Cortex\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cortex-290c0c42.mintlify.site/_mintlify/api/og/v2?division=Catalogs+overview\u0026amp;title=Managing+catalogs\u0026amp;theme=99c32ff148ebb22d9370f9e9\u0026amp;signature=1a7ab4a089a7e1422cf1e4794c2c3af798229d4931cf76e18a8ffa2a7009f853\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/cortex-290c0c42/GsIUSGAJ7s7HMHgE/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cortex\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#653EE8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cortex.io/ingesting-data-into-cortex/catalogs/managing-catalogs\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ingesting-data-into-cortex/catalogs/managing-catalogs.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cortex.io/#organization\",\"name\":\"Cortex\",\"url\":\"https://docs.cortex.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cortex-290c0c42/JcmXgfdiEzZzqS2M/logo/cortex-light.svg?fit=max\u0026auto=format\u0026n=JcmXgfdiEzZzqS2M\u0026q=85\u0026s=3d32dd91336a0de9463a57e04f9b8bb3\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cortex.io#website\",\"name\":\"Cortex\",\"url\":\"https://docs.cortex.io\",\"publisher\":{\"@id\":\"https://docs.cortex.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cortex.io/ingesting-data-into-cortex/catalogs/managing-catalogs#webpage\",\"url\":\"https://docs.cortex.io/ingesting-data-into-cortex/catalogs/managing-catalogs\",\"name\":\"Managing catalogs\",\"dateModified\":\"2026-09-09T13:38:06.000Z\",\"isPartOf\":{\"@id\":\"https://docs.cortex.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cortex.io/ingesting-data-into-cortex/catalogs/managing-catalogs#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cortex.io/ingesting-data-into-cortex/catalogs/managing-catalogs#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Connect data\",\"item\":\"https://docs.cortex.io/ingesting-data-into-cortex/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Catalogs overview\",\"item\":\"https://docs.cortex.io/ingesting-data-into-cortex/catalogs\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Managing catalogs\",\"item\":\"https://docs.cortex.io/ingesting-data-into-cortex/catalogs/managing-catalogs\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cortex.io/ingesting-data-into-cortex/catalogs/managing-catalogs#article\",\"headline\":\"Managing catalogs\",\"name\":\"Managing catalogs\",\"url\":\"https://docs.cortex.io/ingesting-data-into-cortex/catalogs/managing-catalogs\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cortex.io/ingesting-data-into-cortex/catalogs/managing-catalogs#webpage\"},\"dateModified\":\"2026-09-09T13:38:06.000Z\",\"publisher\":{\"@id\":\"https://docs.cortex.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cortex.io#website\"}}]}\u003c/script>","agentPointerHref":"/ingesting-data-into-cortex/catalogs/managing-catalogs.md","siteName":"Cortex","nav":{"global":null,"tabs":[{"tab":"Product Docs","icon":"books","groups":[{"group":"Cortex","pages":[{"title":"Home","mode":"frame","href":""}]},{"group":"Get Started","pages":[{"group":"Cortex quick start guide","root":{"title":"Cortex quick start guide","href":"/get-started/quickstart"},"pages":[{"title":"Getting started: Logging in to Cortex and configuring your workspace","href":"/get-started/quickstart/getting-started-logging-in-to-cortex-and-configuring-your-workspace"},{"title":"Laying the foundation: Data modeling, integrations, and identity mapping","href":"/get-started/quickstart/laying-the-foundation-data-modeling-integrations-and-identity-mapping"},{"title":"Building on the foundation: Catalogs, Scorecards, Workflows, and Eng Intelligence","href":"/get-started/quickstart/building-on-the-foundation-catalogs-scorecards-workflows-and-eng-intelligence"},{"title":"Going further with Cortex","href":"/get-started/quickstart/going-further-with-cortex"}]},{"group":"AI in Cortex","root":{"title":"AI in Cortex","href":"/get-started/cortex-ai-assistant"},"pages":[{"title":"Cortex AI prompt library","href":"/get-started/cortex-ai-assistant/library"},{"group":"Cortex MCP","root":{"title":"Cortex MCP","href":"/get-started/cortex-ai-assistant/mcp"},"pages":[{"title":"Configuring the Cortex MCP","href":"/get-started/cortex-ai-assistant/mcp/configuring-cortex-mcp"},{"title":"Using the Cortex MCP","href":"/get-started/cortex-ai-assistant/mcp/using-cortex-mcp"},{"title":"Signing in to the remote Cortex MCP with OAuth","href":"/get-started/cortex-ai-assistant/mcp/mcp-oauth"},{"title":"Using the Cortex MCP in Glean","href":"/get-started/cortex-ai-assistant/mcp/glean"}]},{"title":"Cortex AI chat","tag":"RESEARCH PREVIEW","href":"/cortex-ai-chat"}]}]},{"group":"Connect data","pages":[{"title":"Ingesting data into Cortex","href":"/ingesting-data-into-cortex/overview"},{"group":"Entities overview","root":{"title":"Entities overview","href":"/ingesting-data-into-cortex/entities-overview"},"pages":[{"group":"Managing entities","root":{"title":"Managing entities","href":"/ingesting-data-into-cortex/entities-overview/entities"},"pages":[{"group":"Defining entities with YAML","root":{"title":"Defining entities with YAML","href":"/ingesting-data-into-cortex/entities-overview/entities/yaml"},"pages":[{"title":"YAML linter tool","href":"/ingesting-data-into-cortex/entities-overview/entities/yaml/linter"}]},{"group":"Adding entities","root":{"title":"Adding entities","href":"/ingesting-data-into-cortex/entities-overview/entities/adding-entities"},"pages":[{"title":"Adding services","href":"/ingesting-data-into-cortex/entities-overview/entities/adding-entities/add-services"},{"title":"Adding domains","href":"/ingesting-data-into-cortex/entities-overview/entities/adding-entities/domains"},{"group":"Adding teams","root":{"title":"Adding teams","href":"/ingesting-data-into-cortex/entities-overview/entities/adding-entities/teams"},"pages":[{"title":"Viewing teams","href":"/ingesting-data-into-cortex/entities-overview/entities/adding-entities/teams/viewing-teams"},{"title":"Team roles","href":"/ingesting-data-into-cortex/entities-overview/entities/adding-entities/teams/team-roles"},{"title":"Team ownership entity editing","href":"/ingesting-data-into-cortex/entities-overview/entities/adding-entities/teams/team-entity-editing"}]},{"group":"Adding custom entity types","root":{"title":"Adding custom entity types","href":"/ingesting-data-into-cortex/entities-overview/entities/adding-entities/entity-types"},"pages":[{"title":"Creating custom entities","href":"/ingesting-data-into-cortex/entities-overview/entities/adding-entities/entity-types/creating-custom-entities"},{"title":"Managing custom entities","href":"/ingesting-data-into-cortex/entities-overview/entities/adding-entities/entity-types/managing-custom-entities"},{"title":"Managing custom entity types","href":"/ingesting-data-into-cortex/entities-overview/entities/adding-entities/entity-types/managing-custom-entity-types"}]},{"title":"Defining dependencies","href":"/ingesting-data-into-cortex/entities-overview/entities/adding-entities/dependencies"}]},{"title":"Entity details page","href":"/ingesting-data-into-cortex/entities-overview/entities/details"},{"group":"Ownership","root":{"title":"How ownership works","href":"/ingesting-data-into-cortex/entities-overview/entities/ownership"},"pages":[{"title":"Ownership best practices","href":"/ingesting-data-into-cortex/entities-overview/entities/ownership/ownership-best-practices"},{"title":"Assigning owners to entities","href":"/ingesting-data-into-cortex/entities-overview/entities/ownership/assigning-owners-to-entities"},{"title":"Ownership inheritance","href":"/ingesting-data-into-cortex/entities-overview/entities/ownership/ownership-inheritance"},{"title":"Viewing and managing ownership","href":"/ingesting-data-into-cortex/entities-overview/entities/ownership/viewing-and-managing-ownership"},{"title":"Ownership sources reference","href":"/ingesting-data-into-cortex/entities-overview/entities/ownership/ownership-sources"}]},{"group":"Defining relationship types","root":{"title":"Defining relationship types","href":"/ingesting-data-into-cortex/entities-overview/entities/defining-relationship-types"},"pages":[{"title":"Managing relationships","href":"/ingesting-data-into-cortex/entities-overview/entities/defining-relationship-types/managing-relationships"}]},{"title":"Grouping entities","href":"/ingesting-data-into-cortex/entities-overview/entities/groups"},{"title":"Adding external documentation","href":"/ingesting-data-into-cortex/entities-overview/entities/external-docs"},{"title":"Adding deployment data via API","href":"/ingesting-data-into-cortex/entities-overview/entities/deploys"},{"title":"Adding custom data","href":"/ingesting-data-into-cortex/entities-overview/entities/custom-data"},{"title":"Discovered entities","href":"/ingesting-data-into-cortex/entities-overview/entities/discovery-audit"},{"group":"Archiving entities","root":{"title":"Archiving entities","href":"/ingesting-data-into-cortex/entities-overview/entities/archiving-entities"},"pages":[{"title":"Archiving entities automatically","href":"/ingesting-data-into-cortex/entities-overview/entities/archiving-entities/auto-archive"},{"title":"Deleting archived entities automatically","href":"/ingesting-data-into-cortex/entities-overview/entities/archiving-entities/auto-delete"},{"title":"Archiving entities manually","href":"/ingesting-data-into-cortex/entities-overview/entities/archiving-entities/archiving-entities-manually"}]},{"title":"Relationship graphs","href":"/ingesting-data-into-cortex/entities-overview/entities/relationship-graph"},{"title":"Using On-call Assistant for incident notifications","href":"/ingesting-data-into-cortex/entities-overview/entities/oncall-assistant"},{"group":"Managing Terraform infra in Cortex","root":{"title":"Managing Terraform infra in Cortex","href":"/ingesting-data-into-cortex/entities-overview/entities/terraform"},"pages":[{"title":"Manage entities using Cortex Terraform Provider","href":"/ingesting-data-into-cortex/entities-overview/entities/terraform/terraform-provider"}]}]}]},{"group":"Catalogs overview","root":{"title":"Catalogs overview","href":"/ingesting-data-into-cortex/catalogs"},"pages":[{"title":"Viewing catalogs","description":null,"href":"/ingesting-data-into-cortex/catalogs/viewing-catalogs"},{"title":"Managing catalogs","href":"/ingesting-data-into-cortex/catalogs/managing-catalogs"}]},{"group":"Integrations","root":{"title":"Integrations","description":null,"href":"/ingesting-data-into-cortex/integrations"},"pages":[{"title":"Internally hosted integrations","href":"/ingesting-data-into-cortex/integrations/axon-relay"},{"group":"Apiiro","root":{"title":"Apiiro","href":"/ingesting-data-into-cortex/integrations/apiiro"},"pages":[{"title":"Connecting entities to Apiiro","href":"/ingesting-data-into-cortex/integrations/apiiro/connecting-entities-to-apiiro"},{"title":"Using the integration for Apiiro","href":"/ingesting-data-into-cortex/integrations/apiiro/using-the-integration-for-apiiro"}]},{"title":"ArgoCD","href":"/ingesting-data-into-cortex/integrations/argocd"},{"group":"AWS","root":{"title":"AWS","href":"/ingesting-data-into-cortex/integrations/aws"},"pages":[{"title":"Importing entities from AWS","href":"/ingesting-data-into-cortex/integrations/aws/importing-entities-from-aws"},{"title":"Using the integration for AWS","href":"/ingesting-data-into-cortex/integrations/aws/using-the-integration-for-aws"}]},{"title":"Azure DevOps","href":"/ingesting-data-into-cortex/integrations/azuredevops"},{"title":"Azure Resources","href":"/ingesting-data-into-cortex/integrations/azureresources"},{"title":"BambooHR","href":"/ingesting-data-into-cortex/integrations/bamboohr"},{"title":"Bitbucket","href":"/ingesting-data-into-cortex/integrations/bitbucket"},{"title":"BugSnag","href":"/ingesting-data-into-cortex/integrations/bugsnag"},{"title":"Buildkite","href":"/ingesting-data-into-cortex/integrations/buildkite"},{"title":"Checkmarx","href":"/ingesting-data-into-cortex/integrations/checkmarx"},{"title":"CircleCI","href":"/ingesting-data-into-cortex/integrations/circleci"},{"title":"Claude","tag":"PRIVATE BETA","href":"/ingesting-data-into-cortex/integrations/claude"},{"title":"ClickUp","href":"/ingesting-data-into-cortex/integrations/clickup"},{"title":"Codecov","href":"/ingesting-data-into-cortex/integrations/codecov"},{"title":"Coralogix","href":"/ingesting-data-into-cortex/integrations/coralogix"},{"title":"Custom webhook integrations","href":"/ingesting-data-into-cortex/integrations/webhook"},{"group":"Datadog","root":{"title":"Datadog","href":"/ingesting-data-into-cortex/integrations/datadog"},"pages":[{"title":"Connecting entities to Datadog","href":"/ingesting-data-into-cortex/integrations/datadog/connecting-entities-to-datadog"},{"title":"Using the integration for Datadog","href":"/ingesting-data-into-cortex/integrations/datadog/using-the-integration-for-datadog"}]},{"title":"Dynatrace","href":"/ingesting-data-into-cortex/integrations/dynatrace"},{"title":"Entra ID","href":"/ingesting-data-into-cortex/integrations/entraid"},{"title":"FireHydrant","href":"/ingesting-data-into-cortex/integrations/firehydrant"},{"title":"GitHub","href":"/ingesting-data-into-cortex/integrations/github"},{"title":"GitLab","href":"/ingesting-data-into-cortex/integrations/gitlab"},{"group":"Google Cloud Platform","root":{"title":"Google Cloud Platform","href":"/ingesting-data-into-cortex/integrations/google"},"pages":[{"title":"Connecting entities to Google Cloud Platform","href":"/ingesting-data-into-cortex/integrations/google/connecting-entities-to-google-cloud-platform"},{"title":"Using the integration for Google Cloud Platform","href":"/ingesting-data-into-cortex/integrations/google/using-the-integration-for-google-cloud-platform"}]},{"title":"Grafana","href":"/ingesting-data-into-cortex/integrations/grafana"},{"group":"Harness","root":{"title":"Harness","href":"/ingesting-data-into-cortex/integrations/harness"},"pages":[{"title":"Importing data from Harness","href":"/ingesting-data-into-cortex/integrations/harness/importing-data-from-harness"},{"title":"Using the integration for Harness","href":"/ingesting-data-into-cortex/integrations/harness/using-the-integration-for-harness"}]},{"title":"Humanitec","href":"/ingesting-data-into-cortex/integrations/humanitec"},{"group":"incident.io","root":{"title":"incident.io","href":"/ingesting-data-into-cortex/integrations/incidentio"},"pages":[{"title":"Connecting entities to incident.io","href":"/ingesting-data-into-cortex/integrations/incidentio/connecting-entities-to-incident.io"},{"title":"Using the integration for incident.io","href":"/ingesting-data-into-cortex/integrations/incidentio/using-the-integration-for-incident.io"}]},{"title":"Instana","href":"/ingesting-data-into-cortex/integrations/instana"},{"title":"Jenkins","href":"/ingesting-data-into-cortex/integrations/jenkins"},{"title":"Jira","href":"/ingesting-data-into-cortex/integrations/jira"},{"group":"Kubernetes","root":{"title":"Kubernetes","href":"/ingesting-data-into-cortex/integrations/kubernetes"},"pages":[{"title":"Connecting entities to Kubernetes","href":"/ingesting-data-into-cortex/integrations/kubernetes/connecting-entities-to-kubernetes"},{"title":"Using the integration for Kubernetes","href":"/ingesting-data-into-cortex/integrations/kubernetes/using-the-integration-for-kubernetes"}]},{"title":"LaunchDarkly","href":"/ingesting-data-into-cortex/integrations/launchdarkly"},{"title":"Lightstep","href":"/ingesting-data-into-cortex/integrations/lightstep"},{"title":"Mend","href":"/ingesting-data-into-cortex/integrations/mend"},{"title":"Microsoft Teams","href":"/ingesting-data-into-cortex/integrations/microsoftteams"},{"title":"New Relic","href":"/ingesting-data-into-cortex/integrations/newrelic"},{"title":"Okta","href":"/ingesting-data-into-cortex/integrations/okta"},{"title":"Opsgenie","href":"/ingesting-data-into-cortex/integrations/opsgenie"},{"group":"PagerDuty","root":{"title":"PagerDuty","href":"/ingesting-data-into-cortex/integrations/pagerduty"},"pages":[{"title":"Connecting entities to PagerDuty","href":"/ingesting-data-into-cortex/integrations/pagerduty/connecting-entities-to-pagerduty"},{"title":"Using the integration for PagerDuty","href":"/ingesting-data-into-cortex/integrations/pagerduty/using-the-integration-for-pagerduty"}]},{"title":"Prometheus","href":"/ingesting-data-into-cortex/integrations/prometheus"},{"title":"Rollbar","href":"/ingesting-data-into-cortex/integrations/rollbar"},{"group":"Rootly","root":{"title":"Rootly","href":"/ingesting-data-into-cortex/integrations/rootly"},"pages":[{"title":"Connecting entities to Rootly","href":"/ingesting-data-into-cortex/integrations/rootly/connecting-entities-to-rootly"},{"title":"Using the integration for Rootly","href":"/ingesting-data-into-cortex/integrations/rootly/using-the-integration-for-rootly"}]},{"title":"Semgrep","href":"/ingesting-data-into-cortex/integrations/semgrep"},{"title":"Sentry","href":"/ingesting-data-into-cortex/integrations/sentry"},{"title":"ServiceNow","href":"/ingesting-data-into-cortex/integrations/servicenow"},{"group":"Slack","root":{"title":"Slack","href":"/ingesting-data-into-cortex/integrations/slack"},"pages":[{"title":"Using the integration for Slack","href":"/ingesting-data-into-cortex/integrations/slack/using-the-integration-for-slack-ai-assistant"},{"title":"Slack integration FAQ and troubleshooting","href":"/ingesting-data-into-cortex/integrations/slack/slack-integration-faq-and-troubleshooting"}]},{"title":"Snyk","href":"/ingesting-data-into-cortex/integrations/snyk"},{"title":"SonarQube","href":"/ingesting-data-into-cortex/integrations/sonarqube"},{"group":"Splunk Observability Cloud","root":{"title":"Splunk Observability Cloud (SignalFx)","href":"/ingesting-data-into-cortex/integrations/splunk-observability"},"pages":[{"title":"Connecting entities to Splunk Observability Cloud SLOs","tag":"PUBLIC BETA","href":"/ingesting-data-into-cortex/integrations/splunk-observability/connecting-entities-to-splunk-observability"},{"title":"Using the integration for Splunk Observability Cloud","tag":"PUBLIC BETA","href":"/ingesting-data-into-cortex/integrations/splunk-observability/using-the-integration-for-splunk-observability"}]},{"group":"Splunk On-Call","root":{"title":"Splunk On-Call (VictorOps)","href":"/ingesting-data-into-cortex/integrations/splunk-oncall"},"pages":[{"title":"Connecting entities to Splunk On-Call","tag":"PUBLIC BETA","href":"/ingesting-data-into-cortex/integrations/splunk-oncall/connecting-entities-to-splunk-oncall"},{"title":"Using the integration for Splunk On-Call","tag":"PUBLIC BETA","href":"/ingesting-data-into-cortex/integrations/splunk-oncall/using-the-integration-for-splunk-oncall"}]},{"title":"Sumo Logic","href":"/ingesting-data-into-cortex/integrations/sumologic"},{"title":"Syntasso Kratix Enterprise (SKE)","href":"/ingesting-data-into-cortex/integrations/syntasso"},{"title":"Veracode","href":"/ingesting-data-into-cortex/integrations/veracode"},{"title":"Wiz","href":"/ingesting-data-into-cortex/integrations/wiz"},{"group":"Workday","root":{"title":"Workday","href":"/ingesting-data-into-cortex/integrations/workday"},"pages":[{"title":"Using the integration for Workday","href":"/ingesting-data-into-cortex/integrations/workday/using-the-integration-for-workday"}]},{"title":"xMatters","href":"/ingesting-data-into-cortex/integrations/xmatters"}]}]},{"group":"Standardize","pages":[{"group":"Scorecards overview","root":{"title":"Scorecards overview","href":"/standardize/scorecards"},"pages":[{"title":"Create a Scorecard","href":"/standardize/scorecards/create"},{"title":"Reviewing and evaluating Scorecards","href":"/standardize/scorecards/evaluate"},{"title":"Scorecard rule exemptions","href":"/standardize/scorecards/rule-exemptions"},{"title":"Scorecard rule filters","href":"/standardize/scorecards/scorecard-filters"},{"title":"Scorecard examples","href":"/standardize/scorecards/scorecard-examples"},{"title":"Scorecards as code","href":"/standardize/scorecards/scorecards-as-code"},{"title":"Scorecard troubleshooting and FAQ","href":"/standardize/scorecards/scorecard-troubleshooting-and-faq"}]},{"group":"Cortex Query Language (CQL)","root":{"title":"Cortex Query Language (CQL)","href":"/standardize/cql"},"pages":[{"title":"Running and saving CQL queries","href":"/standardize/cql/run"},{"title":"Using CQL reports","href":"/standardize/cql/cql-reports"},{"title":"Using JQ in Cortex","href":"/standardize/cql/using-jq"}]}]},{"group":"Improve","pages":[{"group":"OpEx Review","root":{"title":"OpEx Review","tag":"PUBLIC BETA","href":"/improve/opex-review"},"pages":[{"title":"Configuring OpEx Review","tag":"PUBLIC BETA","href":"/improve/opex-review/configuring-opex"},{"title":"Using the OpEx Review report","tag":"PUBLIC BETA","href":"/improve/opex-review/using-opex"},{"title":"Using Cortex AI in OpEx Review","tag":"RESEARCH PREVIEW","href":"/improve/opex-review/using-opex-ai-chat"},{"title":"OpEx Review FAQ","tag":"PUBLIC BETA","href":"/improve/opex-review/opex-faq"}]},{"group":"Eng Intelligence","root":{"title":"Eng Intelligence","href":"/improve/eng-intelligence"},"pages":[{"group":"Dashboards","root":{"title":"Dashboards","href":"/improve/eng-intelligence/dashboards"},"pages":[{"title":"DORA Dashboard","href":"/improve/eng-intelligence/dora-dashboard"},{"title":"Velocity Dashboard","href":"/improve/eng-intelligence/velocity-dashboard"},{"group":"AI Dashboard","root":{"title":"AI Dashboard","tag":"PRIVATE BETA","href":"/improve/eng-intelligence/dashboards/ai-impact"},"pages":[{"title":"GitHub Copilot in the AI Dashboard","tag":"PRIVATE BETA","href":"/improve/eng-intelligence/dashboards/ai-impact/github-copilot"},{"title":"Claude Code in the AI Dashboard","tag":"PRIVATE BETA","href":"/improve/eng-intelligence/dashboards/ai-impact/claude-code"}]},{"group":"Custom dashboards","root":{"title":"Custom dashboards","href":"/improve/eng-intelligence/dashboards/custom"},"pages":[{"title":"Managing custom dashboards","href":"/improve/eng-intelligence/dashboards/custom/managing-custom-dashboards"}]}]},{"group":"Data Explorer","root":{"title":"Data Explorer","href":"/improve/eng-intelligence/data-explorer"},"pages":[{"title":"Available metrics in Data Explorer","href":"/improve/eng-intelligence/data-explorer/available-metrics-in-data-explorer"},{"title":"Data Explorer reference","href":"/improve/eng-intelligence/data-explorer/data-explorer-reference"}]},{"title":"Custom metrics","href":"/improve/eng-intelligence/custom-metrics"}]},{"group":"Initiatives and Action items","root":{"title":"Initiatives and Action items","href":"/improve/initiatives"},"pages":[{"title":"Creating issues based on Initiatives","href":"/improve/initiatives/issue-config"}]},{"group":"Reports","root":{"title":"Reports","href":"/improve/reports"},"pages":[{"title":"Executive report","href":"/improve/reports/executive-report"},{"title":"All Scorecards report","href":"/improve/reports/all-scorecards"},{"group":"Bird's eye report","root":{"title":"Bird's eye report","href":"/improve/reports/birds-eye"},"pages":[{"title":"Legacy Bird's Eye report","hidden":true,"href":"/improve/reports/birds-eye/legacy-birds-eye-report"}]},{"title":"Progress report","href":"/improve/reports/progress-report"},{"title":"Report card","href":"/improve/reports/report-card"}]}]},{"group":"Streamline","pages":[{"group":"Workflows","root":{"title":"Workflows","href":"/streamline/workflows"},"pages":[{"title":"Creating a Workflow","href":"/streamline/workflows/create"},{"title":"Configuring Workflow settings","href":"/streamline/workflows/configuring-workflow-settings"},{"group":"Adding blocks to a Workflow","root":{"title":"Adding blocks to a Workflow","href":"/streamline/workflows/blocks"},"pages":[{"title":"Using request signing with Workflow blocks","href":"/streamline/workflows/blocks/using-request-signing-with-workflow-blocks"},{"title":"Referencing a Workflow state in a block","href":"/streamline/workflows/blocks/states"},{"title":"Workflow block configuration reference","href":"/streamline/workflows/blocks/block-configuration-reference"}]},{"title":"Running a Workflow","href":"/streamline/workflows/run"},{"title":"Publishing a Workflow","href":"/streamline/workflows/publishing-a-workflow"},{"title":"Viewing Workflows","href":"/streamline/workflows/viewing-workflows"},{"title":"Workflows as code","href":"/streamline/workflows/workflows-as-code"},{"title":"Example Workflow definitions","href":"/streamline/workflows/example-workflow-definitions"},{"group":"Registering a Scaffolder template","root":{"title":"Registering a Scaffolder template","href":"/streamline/workflows/scaffolder"},"pages":[{"title":"Scaffolder advanced usage","href":"/streamline/workflows/scaffolder/advanced-usage"},{"title":"Convert a GitHub repo to a Cookiecutter template","href":"/streamline/workflows/scaffolder/convert-template"}]}]},{"group":"Plugins","root":{"title":"Plugins","href":"/streamline/plugins"},"pages":[{"title":"Plugin Marketplace","href":"/streamline/plugins/marketplace"},{"group":"Creating a plugin","root":{"title":"Creating a plugin","href":"/streamline/plugins/creating-plugins"},"pages":[{"title":"Creating a plugin proxy","href":"/streamline/plugins/creating-plugins/plugin-proxy"},{"title":"Editing a plugin","href":"/streamline/plugins/creating-plugins/editing-a-plugin"},{"title":"Plugin development reference","href":"/streamline/plugins/creating-plugins/plugin-development-reference"},{"title":"Styling plugins with theme tokens","href":"/styling-plugins-with-theme-tokens"}]},{"title":"Migrating Backstage plugins to Cortex","href":"/streamline/plugins/backstage-migration"},{"title":"Calling internal service endpoints via plugin proxy","href":"/streamline/plugins/calling-internal-service-endpoints-via-plugin-proxy"}]},{"title":"Engineering homepage","href":"/streamline/homepage"}]},{"group":"Configure","pages":[{"group":"Workspace Settings","root":{"title":"Workspace Settings","href":"/configure/settings"},"pages":[{"title":"Customizing your workspace","href":"/configure/settings/workspace-customization"},{"group":"Entity settings","root":{"title":"Entity settings","href":"/configure/settings/entity-settings"},"pages":[{"group":"Data verification","pages":[{"title":"Data verification","href":"/configure/settings/entity-settings/verification"},{"title":"Viewing and verifying data verifications","href":"/configure/settings/entity-settings/viewing-and-verifying-data-verifications"}]}]},{"title":"GitOps settings","href":"/configure/settings/gitops-settings"},{"group":"Notifications","root":{"title":"Notifications","href":"/configure/settings/notifications"},"pages":[{"title":"Notification logs","href":"/configure/settings/notifications/logs"}]},{"title":"Scorecard settings","href":"/configure/settings/scorecard"},{"group":"API keys, secrets, and tokens","root":{"title":"API keys, secrets, and tokens","href":"/configure/settings/api-keys"},"pages":[{"title":"Secrets","href":"/configure/settings/api-keys/secrets"},{"title":"Personal tokens","href":"/configure/settings/api-keys/personal-tokens"}]},{"title":"Audit logs","href":"/configure/settings/audit-logs"},{"title":"Adding an IP allowlist","href":"/configure/settings/ip-allowlist"},{"group":"Managing users and roles","root":{"title":"Managing users and roles","href":"/configure/settings/managing-users"},"pages":[{"group":"Roles and permissions","root":{"title":"Roles and permissions","href":"/configure/settings/managing-users/permissioning"},"pages":[{"title":"Assigning roles to users and teams","href":"/configure/settings/managing-users/permissioning/assigning-roles"},{"title":"Custom roles","href":"/configure/settings/managing-users/permissioning/custom-roles"},{"title":"Permissions reference","href":"/configure/settings/managing-users/permissioning/permissions-reference"}]},{"title":"Adding and removing users","href":"/configure/settings/managing-users/adding-and-removing-users"},{"group":"Configuring SSO for Cortex workspace logins","root":{"title":"Configuring SSO for Cortex workspace logins","href":"/configure/settings/managing-users/configuring-sso"},"pages":[{"title":"Entra ID SSO","href":"/configure/settings/managing-users/configuring-sso/entraid"},{"title":"Google SSO","href":"/configure/settings/managing-users/configuring-sso/google"},{"title":"Okta SSO","href":"/configure/settings/managing-users/configuring-sso/okta"},{"title":"Other OIDC SSO providers","href":"/configure/settings/managing-users/configuring-sso/oidc"}]},{"group":"Provisioning users with SCIM","root":{"title":"Provisioning Cortex users with SCIM","href":"/configure/settings/managing-users/scim/provisioning-users-with-scim"},"pages":[{"title":"Configuring SCIM in Cortex","href":"/configure/settings/managing-users/scim/configuring-scim"},{"title":"Configuring Microsoft Entra ID SCIM for Cortex","href":"/configure/settings/managing-users/scim/entraid-scim"},{"title":"Provisioning roles with SCIM","tag":"PRIVATE BETA","href":"/configure/settings/managing-users/scim/scim-role-provisioning"},{"title":"Configuring Okta SCIM for Cortex","href":"/configure/settings/managing-users/scim/okta-scim"}]},{"title":"Configuring identity mappings","href":"/configure/settings/managing-users/identity-mapping"},{"title":"Onboarding management","href":"/configure/settings/managing-users/onboarding-mgmt"}]},{"title":"Using search in Cortex","href":"/configure/settings/search"}]},{"group":"GitOps for Cortex overview","root":{"title":"GitOps for Cortex overview","href":"/configure/gitops"},"pages":[{"title":"Using GitOps for Cortex","href":"/configure/gitops/using-gitops-for-cortex"},{"title":"GitOps logs","href":"/configure/gitops/gitops-logs"}]},{"title":"Cortex Command Line Interface","href":"/configure/cortex-command-line-interface"}]},{"group":"Resources","pages":[{"title":"Cortex beta program and release phases","href":"/resources/beta"},{"title":"Further help","href":"/resources/help"}]}]},{"tab":"Cookbooks","icon":"hat-chef","pages":[{"title":"Cookbooks","href":"/guides"}]},{"tab":"API Reference","icon":"brain","pages":[{"title":"API Reference","href":"/api"}]},{"tab":"Changelog","icon":"clock-rotate-left","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Managing catalogs - Cortex","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}