Customer Privacy API visitorConsentCollected event return name changes

Retired Boards Appdev Store Design

Topic summary

Main issue: The Customer Privacy API’s visitorConsentCollected event began returning different property names than documented, changing from firstPartyMarketingAllowed/thirdPartyMarketingAllowed to marketingAllowed/saleOfDataAllowed, alongside analyticsAllowed and preferencesAllowed. This unexpected change broke existing implementations; there was also a 400 Bad Request outage the prior week.

Customer request: Clarify when the rename occurred (to assess data reliability), update official documentation, and announce changes via the Shopify changelogs in advance.

Shopify response: A staff member engaged the internal dev team and attempted a revert. Initially, the reporter still saw the new naming and asked not to revert but to fix docs.

Follow-up: Staff requested the store URL via DM for verification.

Current state: The event now returns both sets of properties (marketingAllowed and the original firstPartyMarketingAllowed/thirdPartyMarketingAllowed), providing backward compatibility and preventing breakage.

Open questions: Can developers rely on marketingAllowed remaining long term, or should they revert to using the original fields? When exactly did the change occur?

Status: Partially addressed (temporary compatibility implemented). Documentation and changelog updates, and guidance on field stability, are pending.

Summarized with AI on January 13. AI used: gpt-5.
5

Hello Liam,

No at this moment I still am seeing the new naming (I removed cache and tried a few browsers), that is:

document.addEventListener("visitorConsentCollected", (event) => console.log(event.detail));

// ... click on accept ...
{marketingAllowed: true, saleOfDataAllowed: true, analyticsAllowed: true, preferencesAllowed: true}

At this point I would not want it reverted tbh – since I’ve already made the changes to accommodate the new naming.

What I would want is fixing the existing documentation, and a brief explainer on when this change was made so we would know what data to discount.

Also if you plan to make revert change – would be nice to have some advance warning eg. add it to https://changelog.shopify.com/ or https://shopify.dev/changelog/

Thanks