Cookie Consent Manager - Shopify App Integration

Version: 1.2

Last Updated: July 7, 2026

 

Overview

Ensuring compliance with data privacy regulations is a critical aspect of managing an online store. Shopify merchants can achieve this by integrating TrustArc Consent Management Platform (CMP), which enables transparent communication with site visitors about how their data is collected and used.

This guide is designed for Shopify Partners and store administrators to walk through the process of setting up the TrustArc Cookie Consent Manager on a Shopify store.

By following these instructions, you will:

What you can do
Inject the TrustArc script into your selected Shopify theme without code changes
Display the cookie preferences link across the storefront and checkout pages
Display the cookie consent banner across the storefront and checkout pages
Configure category mappings between TrustArc and Shopify
Enable cookie preferences in the site navigation menu
Verify implementation through browser developer tools
Integrating Consent Manager to a Shopify Store

To integrate CCM to your Shopify store, follow the steps outlined below.

1
Log in to your Shopify account.

Shopify login screen
2
In the admin panel, go to Sales channels > Online Store > Themes.

Admin panel Sales channels navigation If Online Store is not visible, use the Search bar to find and select it from Installed sales channels.

Search bar for Online Store in installed channels
3
For faster access, install the TrustArc app from the Shopify App Store. Search for TrustArc from Apps, then click Search "TrustArc" in Shopify App Store.

Search TrustArc in Shopify App Store
4
A new tab opens displaying search results. Select TrustArc.

TrustArc in Shopify App Store search results
5
Click Install.

TrustArc app Install button TrustArc app installation confirmation
6
Pin it for easier future access.

Pin TrustArc app for quick access
7
On the TrustArc landing page, click Sign in.

TrustArc landing page Sign in button
8
Enter your Access Identifier and Private Access Key, then click Submit.

Access Identifier and Private Access Key fields Alternatively, click Request Private Shopify Access Identifier and Key for help. Contact the TrustArc support team at support@trustarc.com for the generated key, or reach out to your Technical Account Manager (TAM).
Load TrustArc Script into Theme

Load the TrustArc script in the theme to display the cookie consent banner in the storefront.

1
Under Theme customization, choose your theme from the dropdown and click Activate.

Theme dropdown with Activate button
2
A new tab opens with a Store preview.

Store preview tab
3
Confirm that the TrustArc Script is enabled (1), then click Save (2).

TrustArc Script enabled toggle and Save button
4
The Theme status changes to Active, and the Activate button becomes disabled.

Theme status showing Active
Adding Cookie Consent Banner to Checkout

Checkout extensibility features (specifically Checkout UI extensions) are exclusively available to Shopify Plus merchants. For more information, see https://shopify.dev/docs/apps/build/checkout.

To add the cookie consent banner in the Footer, follow the steps below.

1
Click Edit checkout extension.

Edit checkout extension button
2
Click + Add block and select TrustArc Checkout Banner.

Add block menu with TrustArc Checkout Banner option
3
In the Text field under Block Settings, enter Cookie Preferences.

Block Settings Text field with Cookie Preferences
4
Click Save.
Configuring TrustArc Consent Manager Setup
1
On the TrustArc landing page, go to the Cookies settings section and click Go to settings.

Cookies settings Go to settings button
2
In the TrustArc cookie consent manager setup, all relevant settings and key parameters are automatically linked to the script. Configure the following:
  • Choose the CMP Version: either Pro or Advanced (1).
  • Enter your CMP Script ID (2), then click Save (3).
CMP Version and CMP Script ID fields
3
Map Shopify Cookie Categories in the Shopify categories mapping section. The categories shown depend on the CMP Version and CMP Script ID. Choose from each dropdown:
  • Analytics — Cookies to understand how customers interact with the site
  • Marketing — Cookies for ads and marketing communications based on customer interests
  • Sales of Data — Opt customers out of data sharing/sales
  • Preferences — Opt customers out of preference tracking
Shopify categories mapping dropdowns
Note: The mapping fields are disabled until valid configurations are saved in the TrustArc cookie consent manager setup. For more information on the Customer Privacy API, see https://shopify.dev/docs/api/customer-privacy.
4
Click Save.
Enabling Cookie Preferences Link in Navigation

To connect the cookie preferences to any link from the navigation menu, follow the steps below.

1
In the Settings page, enable Display Cookie Preferences Link (1), then click Save (2).

Display Cookie Preferences Link toggle and Save
2
In the Query Selector field, you may copy this value: #trustarc_cookie_settings.

To customize this, create your own selector. If you want to enable the Cookie Preferences Link, use your custom selector. If you prefer to add Cookie Preferences as a menu item instead, make sure the Cookie Preferences Link is disabled, and set the menu item to use the #trustarc_cookie_settings selector.
3
Go to Content > Menus > Menu Items. Click + Add menu item.

Content Menus Add menu item
Note: You can place the link on any section of the site. Make sure to use the ID defined in the Query Selector.
4
Enter the following:
  • Label: Cookie Preferences
  • Link: #trustarc_cookie_settings
Menu item Label and Link fields
5
Click Save. The Cookie Preferences link will now appear in the site navigation.

Cookie Preferences link in navigation save confirmation Cookie Preferences link visible in site navigation
Enabling Google Consent Mode

Enable Google Consent Mode v2 to dynamically adjust the behavior of Google tags (such as Google Analytics and Google Ads) based on the user's consent choices.

1
In the Settings page, enable Google Consent Mode.

Enable Google Consent Mode toggle
2
Configure the following fields:
  • GA Measurement ID — Your Google Analytics Measurement ID (for example, G-XXXXXXXXXX). Required to use Google Consent Mode with Google Analytics.
  • Enable Data Redaction — When enabled, Google Analytics redacts user data when consent for analytics is not granted.
  • Enable URL Passthrough — When enabled, URL parameters are passed through to Google Analytics even when consent is not granted. Useful for campaign tracking.
  • Consent Type Mapping — Used for setting the consent state. Map each consent type to the desired category.
  • Wait for Update — Specify a millisecond value to control how long to wait before data is sent. This allows the Cookie Consent Manager to load. The recommended setting is 500 ms.
Google Consent Mode configuration fields
3
Click Save.
Additional Configurations
  • CMP Script params — Additional parameters for customizing the CMP script.
  • Consent Behavior — Reflects the consent behavior based on the country's or region's consent experience; used to determine the opt-out experience.
  • Opt-out Setting — Specify the regions that should be treated with an opt-out experience based on consent behavior. Multiple values can be separated by commas (for example, us, eu). Depending on your setup, you can use the notice_behavior cookie or the JS variable truste.eu.bindMap.consentModel for this setting.
Additional configuration fields
Verifying Banner Display
1
Return to the Store preview tab and refresh the page.
2
The cookie banner should now appear in the footer of both the checkout page and the online store.

Cookie banner in online store footer Cookie banner in checkout page footer
Removing Shopify Cookie Consent Banner

To remove the Shopify Default Cookie Consent Banner, follow the steps outlined below.

1
Go to Settings > Customer privacy > Cookie banner.

Settings Customer privacy Cookie banner Cookie banner settings page
2
Under the Regions and content section, disable the Use automated settings feature.

Disable Use automated settings toggle
3
In the Regions field, click Edit.

Regions field Edit button
4
In the Edit regions window, select the regions you want to configure with the Zero Tracker Load or Opt-In strategy. These should match the regions set to use the Zero Tracker Load or Opt-In Consent Model in your Cookie Consent Manager settings. Then click Done.

Edit regions window with region selection
5
Save the settings.

Save settings button
6
Click More actions > Remove cookie banner.

More actions Remove cookie banner option
7
In the Remove cookie banner window, click Remove.

Remove cookie banner confirmation dialog
Debugging and Verification
1
Open your browser and right-click > Inspect > Console.
2
Clear the console, then type trustArcApp.

Browser console showing trustArcApp
3
To check visitor consent status, enter: Shopify.customerPrivacy.currentVisitorConsent().

Browser console showing currentVisitorConsent output
Banner and Cookie Preferences Not Displaying

If, after injecting the elements on the site, you don't see them, you may need to remove the CSS from base.css to prevent display:none on empty divs, which can affect how elements load on the page.

base.css display none issue
Frequently Asked Questions
1. Do Shopify apps automatically respect visitor consent?

Many Shopify apps and tracking solutions are designed to integrate with Shopify's Customer Privacy API to determine whether analytics or marketing tracking should run. However, this ultimately depends on how the individual app has been developed.

When using the TrustArc Shopify App, ensure that the Shopify Category Mapping is configured correctly, as this determines how TrustArc consent categories map to Shopify's Customer Privacy API consent categories.

Shopify Category Mapping configuration

If you find that a Shopify app continues to fire trackers after consent has been denied, we recommend:

  • Confirm whether the app supports Shopify's Customer Privacy API.
  • Review your Shopify Category Mapping within the TrustArc Shopify App.
  • Contact Shopify Support or the app developer to determine whether additional consent configuration is required.
Note: TrustArc cannot modify how third-party Shopify apps implement consent logic.
2. Why are my Custom Pixels not respecting consent?

Custom Pixels rely on Shopify's Customer Privacy API to determine whether tracking is permitted.

Please verify that:

  • The Customer Privacy settings for the Custom Pixel are configured correctly.

    Custom Pixel Customer Privacy settings
  • The TrustArc App Shopify Category Mapping matches your intended consent categories.

If your Custom Pixel continues to fire without consent, Shopify Support is the best resource for guidance on configuring Custom Pixels to properly respect Shopify's Customer Privacy API.

TrustArc  ·  Cookie Consent Manager — Shopify Integration Guide  ·  https://www.support.trustarc.com