> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.hoppyapps.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 🔒 How Shopify Customer Privacy Works with Hoppy Cookie Consent

The Shopify Customer Privacy integration acts as a bridge between the Hoppy Cookie Banner and Shopify's native Customer Privacy API.

Whenever a visitor accepts, declines, or updates their cookie preferences, Hoppy automatically forwards that consent information to Shopify. This ensures Shopify's own tracking systems and privacy-aware apps receive the same consent choices selected by the visitor.

The integration supports the following consent categories:

* 📊 Analytics  
* 🎯 Marketing  
* ⚙️ Preferences  
* 🌍 Sale of Data

---

# **⚠️ Before You Begin**

Before using this integration, make sure:

* Hoppy GDPR EU Cookie Banner is installed and active  
* At least one Cookie Banner is published  
* Your Shopify store supports Shopify Customer Privacy

💡 No API keys, access tokens, or external credentials are required.

If you're unsure whether Customer Privacy is available on your store, check:

**Shopify Admin → Settings → Customer Privacy**

or

**Shopify Admin → Settings → Privacy & Cookies**

depending on your Shopify plan and region.

⚠️ If you're also using the Global Privacy Control (GPC) integration, certain consent categories may automatically be denied for visitors who send a GPC signal.

---

# **🛠️ Step 1 — Open the Integrations Section**

Inside your Shopify Admin:

→ Open **Hoppy GDPR EU Cookie Banner**

→ Click **Integrations** from the left-side navigation menu

Locate the **Shopify Customer Privacy** integration.

---

# **🛠️ Step 2 — Review the Integration**

Open the Shopify Customer Privacy integration card.

Unlike other integrations, there are:

* No API keys  
* No account connections  
* No credential fields  
* No manual configuration settings

The connection is handled automatically by the app.

💡 As long as the integration is available and your banner is active, Hoppy can communicate consent preferences directly to Shopify.

---

# **🛠️ Step 3 — Make Sure Your Cookie Banner Is Published**

The integration relies on visitor consent selections.

To verify your banner is active:

→ Open the **Banners** section

→ Confirm at least one Cookie Banner is **Published**

→ Verify the banner is visible on your storefront

⚠️ If the banner is not published, visitors cannot submit consent choices and Shopify will not receive consent updates.

---

# **🧪 Step 4 — Verify the Integration Is Working**

After publishing the banner, you can verify that consent information is being sent successfully.

---

## **Check Browser Console Logs**

Open your storefront in an Incognito or Private browser window.

Then:

→ Open Developer Tools

→ Open the Console

→ Refresh the page

Look for messages similar to:

Customer Privacy API loaded successfully

and

Tracking consent set successfully

If these messages appear, the connection between Hoppy and Shopify is working correctly.

---

## **Test Consent Changes**

Interact with the Cookie Banner by:

* Accepting all cookies  
* Rejecting all cookies  
* Saving custom preferences

After saving, new consent updates should appear automatically.

### **Example**

If a visitor only accepts Analytics cookies:

analytics: true  
marketing: false  
preferences: false  
sale\_of\_data: false

The values sent to Shopify should match the choices selected by the visitor.

---

# **⚠️ Common Troubleshooting**

## **Customer Privacy API Not Available**

If Shopify's Customer Privacy API is unavailable:

→ Verify your Shopify plan supports Customer Privacy

→ Check Shopify Customer Privacy settings

→ Verify you're testing on a storefront page where Shopify scripts are active

Some preview environments may restrict Shopify privacy functionality.

---

## **Consent Changes Are Not Reaching Shopify**

If consent selections are not updating:

→ Verify the Cookie Banner is published

→ Verify visitors can interact with the banner

→ Check for JavaScript errors in the browser console

→ Confirm another consent app is not overriding Shopify's privacy API

---

## **Marketing or Sale of Data Always Shows as Denied**

This can occur when:

* Global Privacy Control (GPC) is enabled  
* Shopify privacy settings enforce additional restrictions  
* Regional privacy requirements automatically override consent states

Review both Shopify privacy settings and Hoppy integrations if this behavior is unexpected.

---

## **Using Shopify's Native Cookie Banner**

Shopify provides its own native cookie banner in some regions.

If both banners are active:

* Visitor consent may become confusing  
* Multiple consent prompts may appear

For the best experience, use only one cookie banner solution whenever possible.

---

# **⚠️ Important Notes**

### **No Credentials Required**

Unlike most integrations, Shopify Customer Privacy does not require:

* API Keys  
* OAuth Connections  
* Access Tokens

The integration works automatically through Shopify's Customer Privacy API.

---

### **Consent Updates Are Automatic**

Whenever visitors:

* Accept cookies  
* Reject cookies  
* Update preferences

Hoppy automatically forwards the updated consent state to Shopify.

No manual synchronization is required.

---

### **Works with Shopify Privacy-Aware Features**

Consent data can be used by Shopify features and apps that respect the Shopify Customer Privacy API.

This helps maintain consistent consent handling across your storefront.

---

# **🎉 Final Result**

Once everything is configured correctly:

✅ Visitor consent preferences are sent directly to Shopify

✅ Shopify tracking respects visitor consent choices

✅ Privacy-aware Shopify apps receive the same consent state

✅ Consent updates stay synchronized automatically

✅ No manual setup or credentials are required

The Shopify Customer Privacy integration helps keep Shopify's privacy tools aligned with the consent choices collected through your Hoppy Cookie Banner. 🔒

---