> ## Documentation Index
> Fetch the complete documentation index at: https://docs.permutive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuring Identifiers

> How to add, view, and manage identifiers in the Identity Graph dashboard, including custom identifier setup

## Overview

Configure identifiers in the Identity Graph dashboard to define which identity types Permutive recognizes and can collect. Identifiers must be configured before you can send identities of that type via the identify endpoint or import identity data via Connectivity.

<Info>
  **Prerequisites:**

  * Access to a Permutive workspace
  * Workspace permissions to configure Identity settings
</Info>

## Steps

<Steps>
  <Step title="Navigate to Identity section">
    In the Permutive dashboard, click **Identity** in the navigation menu, then open the **Identifiers** tab.
  </Step>

  <Step title="Review existing identifiers">
    View all configured identifiers in the table. Each identifier shows:

    * Identifier name (namespace)
    * Type (User-level or User Group-level)
    * Volume metrics (number of identities)
    * Coverage percentage (compared to total Permutive IDs)
  </Step>

  <Step title="Add a new custom identifier">
    Click **New Custom ID** button. Enter a distinct name for your identifier (this becomes the namespace). Click **Add** to create the identifier.
  </Step>

  <Step title="Select identifier type">
    When creating a new identifier, choose whether it's a **User-level** identifier (for individual users) or **User Group-level** identifier (for households or groups). This determines how the identifier can be used in identity resolution and imports.

    Auto-collection is available (web only) for the following identifiers:

    * Google AMP Client ID (`amp`)
    * Xandr’s 3rd party cookie ID (`appnexus`)
    * SAP Customer Data Cloud / Gigya user ID (`gigya`)
    * IP Address (`ip_address`)
    * Permutive’s 3rd party cookie ID (`pxid`)
    * Sailthru user ID (`sailthru`)
    * Trade Desk’s 3rd party cookie ID (`tradedesk`)

    When adding a new identifier supported by auto-collection:

    * Enter the exact name as it appears above (`ip_address`, `pxid` etc.). This will automatically surface the auto-collection checkbox.
    * Tick the **auto-collection** checkbox to have Permutive’s Web SDK automatically capture that identifier’s value.
  </Step>

  <Step title="Verify identifier appears in list">
    After adding, confirm the new identifier appears in the Identifiers table with its type designation.
  </Step>
</Steps>

<Tip>
  **Tips for configuring identifiers:**

  * Use clear, descriptive names for custom identifiers (e.g., `user_id`, `household_id`, `customer_id`)
  * Standard identifiers like `appnexus`, `pxid`, and `email_sha256` may already be configured
  * User Group-level identifiers are required for importing household/user group membership data
  * Standard Identity Graph supports up to 5 identifier types; contact [Support](mailto:support@permutive.com) to upgrade to Advanced ID Graph for more
  * Identifiers must be configured before sending identities of that type via the identify endpoint
</Tip>

<Warning>
  **Important:**

  * Once an identifier is created, you cannot change its type (User-level vs User Group-level) without contacting [Support](mailto:support@permutive.com)
  * Deleting an identifier prevents new identities of that type from being added, but existing identities remain in the graph
  * Identifier names are case-sensitive and must be unique within your workspace
</Warning>

## Next Steps

<CardGroup cols={2}>
  <Card icon="chart-line" href="/guides/signals/identity/viewing-identifier-details" title="Viewing Identifier Details">
    Learn how to analyze identifier metrics and usage
  </Card>

  <Card icon="code" href="/guides/signals/identity/adding-identities-via-identify" title="Adding Identities via Identify Endpoint">
    Implement the identify endpoint to send identities
  </Card>

  <Card icon="arrow-left" href="/products/signals/identity/identity-graph" title="Back to Identity Graph">
    Return to Identity Graph overview
  </Card>
</CardGroup>