---
title: Editing custom ID token mappings
description: Customize the content of an OIDC ID token by adding custom attributes and their values in PingOne.
component: pingone
page_id: pingone:applications:p1_editcustomidtokenmapping
canonical_url: https://docs.pingidentity.com/pingone/applications/p1_editcustomidtokenmapping.html
revdate: April 28, 2025
page_aliases: ["p1_map_app_attributes.adoc", "p1_map_static_attributes.adoc"]
section_ids:
  mapping-pingone-attributes: Mapping PingOne attributes
  steps: Steps
  mapping-static-attributes: Mapping static attributes
  steps-2: Steps
---

# Editing custom ID token mappings

You can customize the content of an OpenID Connect (OIDC) *(tooltip: \<div class="paragraph">
\<p>An authentication protocol built on top of OAuth that authenticates users and enables clients (relying parties) of all types to request and receive information about authenticated sessions and users. OIDC is extensible, allowing clients to use optional features such as encryption of identity data, discovery of OpenID Providers (OAuth authorization servers), and session management.\</p>
\</div>)* ID token by adding custom attributes and their values.

The claim defined by the mapping is returned in the ID token, regardless of the scopes specified in the authorization request. For example, if you want to include a user's account ID in ID tokens associated with the specified OIDC application, you can map the user's account ID to the `accountId` PingOne user attribute.

You can map PingOne user attributes or static attributes to custom attributes in the application you are adding.

## Mapping PingOne attributes

You can map PingOne attributes to custom attributes in your application. For example, you could map `account ID` in PingOne to `User ID` in the application.

## Steps

1. In the PingOne admin console, go to **Applications > Applications** and browse or search for the application for which you want to map attributes.

   You can also add an application. Learn more in [Adding an application](p1_applications_add_applications.html).

2. Click the application entry to open the details panel for the application.

3. On the **Attribute Mappings** tab, click the **Pencil** icon.

4. Click **[icon: plus, set=fa]Add**.

5. Enter the following:

   * **Attributes**: Enter the custom application attribute, such as `account ID`.

   * **PingOne Mappings**: Select an attribute in the list, such as `User ID`. You can browse or search for attributes.

6. If the value is a required attribute for the application, select the **Required** checkbox.

   |   |                                                                                                                                                                                                                                          |
   | - | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   |   | If you request an ID token with a claim that is marked as required but doesn't have a value, PingOne will return an error. If the value is not marked as required and doesn't have a value, the property will be omitted from the token. |

7. To use the expression builder, click the **Gear** icon. Learn more in [Using the expression builder](../pingone_expression_language/p1_use_expression_builder.html).

8. Click **Save**.

## Mapping static attributes

Some service providers require global values for all users to be passed in the assertion. You can use PingOne to map these keys to fixed values.

## Steps

1. In the PingOne admin console, go to **Applications > Applications** and browse or search for the application for which you want to map attributes.

   You can also add an application. Learn more in [Adding an application](p1_applications_add_applications.html).

2. Click the application entry to open the details panel for the application.

3. On the **Attribute Mappings** tab, click the **Pencil** icon.

4. Click **[icon: plus, set=fa]Add**.

5. Enter the following:

   * **Attributes**: Enter the custom application attribute, such as `Version`.

   * **PingOne Mappings**: Enter a value, such as `2.0`.

6. To use the expression builder, click the **Gear** icon. Learn more in [Using the expression builder](../pingone_expression_language/p1_use_expression_builder.html).

7. Click **Save**.