Customer Card Add-in for Dynamics 365 apps (preview)

[This article is prerelease documentation and is subject to change.]


Dynamics 365 Marketing and Dynamics 365 Customer Insights are now Customer Insights - Journeys and Customer Insights - Data. For more information, see Dynamics 365 Customer Insights FAQs.

Get a 360-degree view of your customers directly in Dynamics 365 apps. With the Customer Card Add-in installed in a supported Dynamics 365 app, you can choose to display customer profile fields, insights, and activity timeline. The add-in will retrieve data from Dynamics 365 Customer Insights without affecting the data in the connected Dynamics 365 app.


  • This is a preview feature.
  • Preview features aren't meant for production use and may have restricted functionality. These features are available before an official release so that customers can get early access and provide feedback.


Install the Customer Card Add-in

The Customer Card Add-in is a solution for customer engagement apps in Dynamics 365. To install the solution:

  1. Go to AppSource and search for Dynamics Customer Card.

  2. Select the Customer Card Add-in on AppSource and select Get It Now.

You may need to sign in with your admin credentials for the Dynamics 365 app to install the solution. It can take some time for the solution to be installed to your environment.

Configure the Customer Card Add-in

  1. As an admin, go to the Settings section in Dynamics 365 and select Solutions.

  2. Select the Display Name link for the Dynamics 365 Customer Insights Customer Card Add-in (Preview) solution.

    Select display name.

  3. Select Sign in and enter the credentials for the admin account you use to configure Customer Insights - Data.


    Check that the browser pop-up blocker does not block the authentication window when you select the Sign in button.

  4. Select the environment you want to fetch data from.

  5. Define the field mapping to records in the Dynamics 365 app. Depending on your data, you can choose to map the following options:

    • To map with a contact, select the field in the Customer table that matches the ID of your contact table.
    • To map with an account, select the field in the Customer table that matches the ID of your account table.

    Contact ID field.

  6. Select Save configuration to save the settings.

  7. Next, you need to assign security roles in Dynamics 365 so users can customize and see the customer card. In Dynamics 365, go to Settings > Permissions > Users. Select the users to edit user roles and select Manage roles.

  8. Assign the Customer Insights Card Customizer role to users who will customize the content shown on the card for the whole organization.

Add Customer Card controls to forms

Depending on your scenario, you can choose to add controls to either the Contact form or Account form.

  1. To add the Customer Card controls to your Contact form, go to the Settings > Customizations in Dynamics 365.

  2. Select Customize the System.

  3. Browse to the Contact table, expand it, and select Forms.

  4. Select the contact form you want to add the Customer Card controls to.

    Select Contact form.

  5. To add a control, in the form editor, drag any field from the Field Explorer to where you want the control to appear.

  6. Select the field on the form that you just added and select Change Properties.

  7. Go to the Controls tab and select Add Control. Choose one of the available custom controls and select Add.

  8. In the Field Properties dialog, clear the Display label on the form check box.

  9. Select the Web option for the control. For the Enrichment control, select which enrichment type you want to display by configuring the enrichmentType field. Add a separate enrichment control for each enrichment type.

  10. Select Save and Publish to publish the updated contact form.

  11. Go to the published contact form. You'll see the newly added control. You might need to sign in the first time you use it.

  12. To customize what you want to show on the custom control, select the edit button in the upper-right corner.

Upgrade Customer Card Add-in

The Customer Card Add-in doesn't upgrade automatically. To upgrade to the latest version, follow these steps in the Dynamics 365 app that has the add-in installed.

  1. In the Dynamics 365 app, go to Settings > Customization and select Solutions.

  2. In the table of add-ins, look for CustomerInsightsCustomerCard and select the row.

  3. Select the Apply Solution Upgrade in the action bar.

    Upgrade the solution in the Customization area of Dynamics 365 apps.

  4. After starting the upgrade process, you'll see a loading indicator until the upgrade completes. If there's no newer version, the upgrade will show an error message.


For troubleshooting information, go to Microsoft Dynamics 365 Customer Insights troubleshooting.