> For the complete documentation index, see [llms.txt](https://docs.didomi.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.didomi.io/integrations/content-management-system-cms/shopify-beta/shopify-checkout-banner.md).

# Shopify checkout banner

{% hint style="success" %}
The Shopify checkout banner is only available for organizations that have a Shopify Plus subscription.
{% endhint %}

The checkout banner is a Shopify-powered consent banner that enables end-users to make consent selections for Shopify consent categories from the checkout page for your Shopify store. The Didomi integration enables your organization to easily add a checkout banner that leverages the configured map between Didomi consent notice purposes and Shopify consent categories.

* [Implement Shopify checkout banner](#implement-shopify-checkout-banner)
* [Checkout banner mapping rules](#checkout-banner-mapping-rules)

{% hint style="warning" %}
**Note**: The checkout banner will only be displayed to end-users who are in the regions configured in your Shopify account. [Click here](/integrations/content-management-system-cms/shopify-beta/configure-shopify-consent-notice-region-s.md#shopify) for more information.
{% endhint %}

***

### Implement Shopify checkout banner

Navigate to your organization's Shopify store that has implemented the Didomi app, and click the **Didomi CMP application** on the left-hand panel.&#x20;

Select **Add Checkout Banner** on the subsequent page.

<figure><img src="/files/MvHQWHxEFsr94rQSvisq" alt="" width="563"><figcaption></figcaption></figure>

Click the **Add checkout banner** button.

<figure><img src="/files/yW9oD47PazJ6ivjASP7K" alt="" width="375"><figcaption></figcaption></figure>

From the checkout editor, navigate to the **Footer** section on the left-hand panel and click **Add block**.

<figure><img src="/files/cuPhWpeNWxG6e5lnTmC8" alt="" width="563"><figcaption></figcaption></figure>

Use the subsequent menu and select the **Didomi Checkout Banner**.

<figure><img src="/files/FZnVVSDcuKjZzEWfm4wj" alt="" width="563"><figcaption></figcaption></figure>

Save your changes when finished. The Shopify checkout banner will be added to your store.

<figure><img src="/files/FYx8No6BQ88aqNB4CVzu" alt="" width="563"><figcaption></figcaption></figure>

### Checkout banner mapping rules

In this section, we will cover some rules to keep in mind as it pertains to selections made via the checkout banner and its relationship to the mapping configured for the Didomi consent notice.

<table data-header-hidden><thead><tr><th width="283.166748046875"></th><th></th></tr></thead><tbody><tr><td>Updates to consent notice purposes</td><td>Any selections/updates made through the checkout banner will automatically update the consent notice purposes and Shopify consent categories initially set via the Didomi consent notice.</td></tr><tr><td>Missing consent notice purpose mapping</td><td><p>If a consent notice purpose is not mapped to a Shopify consent category, your organization's checkout banner will still be displayed.</p><p>End-users can make selections on Shopify consent categories that will then update consent notice purposes and/or vendors (see below) according to your configured mapping</p></td></tr><tr><td>Updates to consent notice vendors</td><td>In order to enable a vendor in your consent notice from the checkout banner, an end-user will need to enable all of the Shopify consent categories that map to the consent notice purposes used by the vendor.</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.didomi.io/integrations/content-management-system-cms/shopify-beta/shopify-checkout-banner.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
