Add and manage app cards (BETA)

Last updated: May 5, 2025

Available with any of the following subscriptions, except where noted:

App cards cards are a way to customize your HubSpot experience and bring actionable data for integrations or other custom functionality. App cards can be built for private apps that are entirely internal to your organization, as well as public apps which you can install from the App Marketplace. App cards can be configured to appear in various locations across HubSpot, including CRM record pages, record preview sidebars, and the help desk ticket sidebar.

This guide walks through how to manage cards installed by connected apps, including how to migrate an updated classic CRM card. For more information about customizing the CRM, check out the following guides:

Manage cards installed by connected apps

Super Admins can add app cards directly from the app's settings if the app is installed from the App Marketplace:

In your HubSpot account, click the settings settings icon in the top navigation bar.
In the left sidebar menu, navigate to Integrations > Connected apps.
Click the name of the app, then click the App cards tab.
On the app card you want to use, click Manage locations.

manage-app-card-locations

In the right panel, select the checkbox next to each view where you want to add the app card. Each tab will display all views for a single CRM object.
Click Save.

Please note:

If a user has customized their view by reordering cards on the CRM record, the newly added card may be in a different position than in the layout editor. Learn how to allow or restrict card reordering in the left and right sidebars.
Editing a team view (Professional and Enterprise only) will only impact the layout for main members of that team. Extra team members will not see layout updates made to the team view. Edits to the Default view will be visible to all users who are not members of a team. Learn more about customizing views.

Migrate a classic CRM card to a new app card

When one of your connected apps has an upgrade available for an existing card, Super Admins and users with Customize record page layout permissions can update it from the connected app's settings page, and may be able to update it directly from the CRM record. Depending on the app, the provider may have upgraded to a new app card for the previous location, or added new card location options that you can configure while updating.

For example, Super Admins and users with Customize record page layout permissions may see something like the following on a CRM record when a card has an update available:

For non-Super Admin users, they'll see a similar message but without the hyperlink. Instead, they'll be prompted to contact an account administrator to update the card:

Update a card from a CRM record

If you're a Super Admin, you can update an existing card from the CRM record:

In your HubSpot account, navigate to a CRM record that currently displays a connected app card:
- Contacts: In your HubSpot account, navigate to CRM > Contacts.
- Companies: In your HubSpot account, navigate to CRM > Companies.
- Deals: In your HubSpot account, navigate to CRM > Deals.
- Tickets: In your HubSpot account, navigate to CRM > Tickets.

Click the name of a record.
Locate the card in the right sidebar. If the card is displaying an upgrade alert, click the Set up now link to navigate to the app's settings.

Proceed to the next section to continue the card update process.

Update a card from the app's settings

To update an existing card from the app's settings:

In your HubSpot account, click the settings settings icon in the top navigation bar.
In the left sidebar menu, navigate to Integrations > Connected apps.
Click the name of the app.
On the settings page, click Manage locations on the new card.