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

# Map User Fields for SSO in Edplay

> Step 1 of the Data Mapping wizard: link your identity provider's attribute names to Edplay's internal user profile fields including name, email, role, avatar, and course access.

This is Step 1 of the Data Mapping wizard. In this step, you configure how employee profile data maps from your identity provider into Edplay by matching your provider's attribute names to Edplay's internal fields.

## Required fields

The following three rows are already listed and cannot be removed:

| Internal field | What it maps                                     | Example external attribute       |
| -------------- | ------------------------------------------------ | -------------------------------- |
| **name**       | The user's display name                          | `displayName`                    |
| **email**      | The unique identifier used to recognize the user | `email` or `mail`                |
| **role**       | The base role, refined further in Step 2         | `role`, `department`, or `group` |

## Optional fields

Click **Add field** to add a new row, then pick one of these from the Internal field dropdown:

| Internal field  | What it maps                                                | Example external attribute |
| --------------- | ----------------------------------------------------------- | -------------------------- |
| **Avatar**      | A URL linking to the user's profile photo                   | `photoURL`                 |
| **Courses**     | Which courses the employee should have access to            | (varies by provider)       |
| **Collections** | Which course collections the employee should have access to | (varies by provider)       |

<Note>
  Edplay pulls the avatar image in automatically once a URL is mapped. The image must be publicly accessible.
</Note>

## Map your fields

<Steps>
  <Step title="Map the name field">
    In the **name** row, type the exact attribute name your identity provider sends for the user's name into the **External field** box on the right (for example, `displayName`).
  </Step>

  <Step title="Map the email field">
    In the **email** row, type the exact attribute name for email (for example, `email` or `mail`).
  </Step>

  <Step title="Map the role field">
    In the **role** row, type the exact attribute name for role, group, or department (for example, `role`, `department`, or `group`).
  </Step>

  <Step title="Add optional fields (if needed)">
    Click **Add field** to add a new row. In the **Internal field** dropdown, select the optional field (for example, **Avatar**). Then, in the **External field** box, type the matching attribute name your identity provider sends (for example, `photoURL`).

    Repeat for every additional optional field you want to map.
  </Step>

  <Step title="Proceed to role mapping">
    Once all required rows have an **External field** value, click **Next step** to continue to role mapping.
  </Step>
</Steps>

Next: [Map Roles](/sso/map-roles)