> For the complete documentation index, see [llms.txt](https://docs.cortex.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cortex.io/configure/settings/managing-users/identity-mapping.md).

# Configuring identity mappings

The identity mappings feature allows you to map accounts from different integrations to Cortex accounts, based on name or email address. With identity mapping, you can not only make sure that integrations are working properly for your team members, but you can also ensure that the [Developer Homepage](/streamline/homepage.md) and [Eng Intelligence](/improve/eng-intelligence.md) features are working as intended with their mappings.

In most cases, Cortex can automatically match user identities across systems with no setup required. When account details differ across tools, Cortex Admins can manually review and map users in **Settings > Identity mappings**.

Identity mapping is available for:

* [Azure DevOps](/ingesting-data-into-cortex/integrations/azuredevops.md)
* [Bitbucket](/ingesting-data-into-cortex/integrations/bitbucket.md)
* [ClickUp](/ingesting-data-into-cortex/integrations/clickup.md)
* [GitHub](/ingesting-data-into-cortex/integrations/github.md)
* [GitLab](/ingesting-data-into-cortex/integrations/gitlab.md)
* [Jira](/ingesting-data-into-cortex/integrations/jira.md)
* [Microsoft Teams](/ingesting-data-into-cortex/integrations/microsoftteams.md)
* [Opsgenie](/ingesting-data-into-cortex/integrations/opsgenie.md)
* [PagerDuty](/ingesting-data-into-cortex/integrations/pagerduty.md)
* [Slack](/ingesting-data-into-cortex/integrations/slack.md)

Git providers and Jira support [multiple mappings per user](#map-multiple-identities-to-users).

## View your personal identity mappings

All of your personal mappings for your established integrations are listed in Cortex under [**Settings > My identity mapping**](https://app.getcortexapp.com/settings/my-integration-accounts).

From this page, you can directly add your OAuth user for GitHub cloud if there’s no mapping. For other integrations, a user with the `Configure identity mappings` permission must configure the identity mappings.

{% hint style="warning" %}
OAuth mapping is only valid for GitHub cloud and not for GitHub Enterprise server.
{% endhint %}

## Viewing and managing all identity mappings

Users with the `Configure Identity Mappings` permission can review all user mappings specific to each configured integration. Every integration you've set up appears on this page, whether or not you've mapped users to it yet.

**To access**:

1. From the main sidebar, click your avatar in the bottom-left corner.
2. Select **Settings**.
3. Scroll to the **Identity mappings section**.<br>

   <div align="left" data-with-frame="true"><figure><img src="https://826863033-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJW7pYRxS4dHS3Hv6wxve%2Fuploads%2FM5pwk01g11Rm6JIiQZLY%2Fidentity-mappings.png?alt=media&amp;token=6dc60f04-564d-4b04-bd2d-b99170f1c9dc" alt="" width="232"><figcaption></figcaption></figure></div>

### Reviewing mapped and unmapped users

1. From the main sidebar, click your avatar in the bottom-left corner.
2. Select **Settings**.
3. Scroll to the **Identity mappings section**.
4. Select the integration whose users you want to review.
5. In the upper-right corner of the integration's **User mappings** page, click **Display**.<br>

   <div align="left" data-with-frame="true"><figure><img src="https://826863033-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJW7pYRxS4dHS3Hv6wxve%2Fuploads%2FC9Gtew4bqUZNy8Peog7j%2Freview-mapped-users.png?alt=media&amp;token=b922450a-7526-4a87-88d7-2b2c4cab20ef" alt="" width="563"><figcaption></figcaption></figure></div>
6. Toggle on or off the following:
   * **Active integrations only** (toggled on by default) - Show mappings only for integration configurations that are currently installed. Uninstalling a configuration doesn't delete the mappings you've saved for it; toggle this setting off to see them again.
   * **Hide mapped users** - Show only the users who don't have a mapping yet.
7. Click **Done**.

#### Mapping unmapped users

While viewing the user mappings for an integration, you can view Cortex's suggestions for user accounts. You can accept suggestions individually by clicking the checkmark next to a suggestion in a user’s row:

<div align="left" data-with-frame="true"><figure><img src="https://826863033-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJW7pYRxS4dHS3Hv6wxve%2Fuploads%2FZ713L5UthJonZcA96pyq%2Fmap-unmapped.png?alt=media&amp;token=30472b7e-0416-494b-9764-16e18d9f0e5a" alt="" width="563"><figcaption></figcaption></figure></div>

To accept multiple suggestions at once, click **Accept all suggestions** at the top of the list. This opens a dialog listing every account that has a suggested mapping, so you can review the suggestions and confirm them for many users at once.

<div align="left" data-with-frame="true"><figure><img src="https://826863033-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJW7pYRxS4dHS3Hv6wxve%2Fuploads%2FTz6DzDAUAkFQWlFCthlw%2Fmapping-bulk.png?alt=media&amp;token=c3aa5599-1741-47d5-87b4-e4c4bebd689d" alt="" width="563"><figcaption></figcaption></figure></div>

If Cortex doesn't have a suggestion, select a mapping for that user from the **Select mapping** drop-down.

### Mapping multiple identities to users

Cortex supports more than one identity per user, so if you run multiple instances of a Git provider or Jira, you can map an identity for each instance alias.

The following providers are supported:

* [Azure DevOps](/ingesting-data-into-cortex/integrations/azuredevops.md)
* [Bitbucket](/ingesting-data-into-cortex/integrations/bitbucket.md)
* [GitHub](/ingesting-data-into-cortex/integrations/github.md)
* [GitLab](/ingesting-data-into-cortex/integrations/gitlab.md)
* [Jira](/ingesting-data-into-cortex/integrations/jira.md)

**To configure multiple mappings for a user**:

1. From the main sidebar, click your avatar in the bottom-left corner.
2. Select **Settings**.
3. Scroll to the **Identity mappings section**.
4. Select the integration whose users you want to map.
5. Locate the user, then click the arrow next to their name to expand their mappings.
6. If an identity isn't mapped yet, the dropdown next to the instance alias suggests a user. Select the user, then click **Save**.
   * When a mapping isn't associated with an alias, the **Identity mappings** settings show a dropdown labeled **Unknown**. This can happen when an integration has multiple aliases configured. The next time Cortex syncs user identity information, it tries to match the mapping to an alias. The **Unknown** label doesn't affect how Cortex works.
   * Cortex lists only the aliases for integration configurations that are currently installed. If an alias you expect is missing from a user's mappings, the configuration it belongs to may have been removed or renamed. Uninstalling a configuration doesn't delete the mappings you've saved for it. To see them, click **Display** at the top of the list, then toggle off **Active integrations only**.

<div align="left" data-with-frame="true"><figure><img src="https://826863033-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJW7pYRxS4dHS3Hv6wxve%2Fuploads%2Fgit-blob-99327e406e62b2f9f3b7cd258ea208e7e02cff19%2Funmapped-users.jpg?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>