Help
Log in

Syncing customer data from your identity provider

After you connect your own identity provider, Shopify automatically syncs customer account data every time a customer signs in. This keeps customer accounts in Shopify up to date with the information stored in your identity provider. You can configure how existing customer data in Shopify is handled when new data is received.

On this page

Configure data sync settings

  1. From your Shopify admin, go to Settings > Customer accounts.

  2. In the Authentication section, click Manage.

  3. In the Identity provider section, click Manage providers.

  4. Click the identity provider to open its settings.

  5. Activate the Sync customer data setting.

  6. In the Overwrite rules section, select how existing customer data in Shopify is handled:

    • To preserve data in existing fields, select Do not overwrite existing customer data. Only empty fields are filled with values from your identity provider.
    • To replace existing data in Shopify, select Overwrite existing customer data. Field groups, such as name, tag, or address, that your identity provider doesn't send are left unchanged.

  7. Click Save.

Supported customer data

Shopify supports syncing the following customer data fields. Which fields are available depends on what your identity provider sends during sign-in. Check with your identity provider to confirm which fields they support.

  • Email address: The customer's email address. This is also used to identify and match customers to existing accounts in Shopify. Shopify syncs the email address only when a customer is created in your store.
  • Name: The customer's first name and last name. These are imported together. When overwriting is enabled, both values are replaced as a pair.
  • Phone number: The customer's phone number.
  • Address: The customer's address, including street, city, province or state, postal code, and country. Your identity provider can send multiple addresses, which are imported as a group.
  • Tags: Customer tags. Tags are imported as a group. When overwriting is enabled, all existing tags are replaced.

If you manage your identity provider's technical configuration, then refer to the ID token claim import documentation for details on token structure and claim mapping.