This article is a comprehensive guide for consent app creators that explains everything you need to know about managing consent policies on Wix sites.
Only 1 consent app should be installed on a site at a time to avoid conflicting changes to consent settings. Make sure you convey this to your users.
Before you read this article, make sure you're familiar with the GDPR and the cookie consent requirements that Wix apps must implement. For information on these topics, see About GDPR and Data Protection Compliance.
There are 2 types of consent policies to be aware of when developing a consent app:
Every visitor to a Wix site has their own visitor consent policy that defines what types of cookies and related technologies they allow.
Visitor consent policies can be managed using the Consent Policy API.
When a visitor first arrives on the site, their visitor consent policy is configured to match the site's default consent policy.
Every site's default consent policy initially allows all types of cookies and related technologies. You can manage a site's default consent policy using the Site Properties API.
You're developing an app that adds a cookie consent banner to a site. When the visitor chooses their consent settings in the banner, you call setConsentPolicy() to update their policy with their chosen settings.
You're developing an app with a cookie consent banner. When a user installs and activates your app, you want to block all types of cookies and related technologies until the visitor specifically consents to them via your banner. To do this, you configure a dashboard page where the user can activate your banner. When they activate it, you call updateConsentPolicy() with all consentPolicy types except essential set to false. If they deactivate your banner, you call updateConsentPolicy() again to reset the default site consent policy to allow all types.
The following are examples of functions you could implement to enable or disable a consent banner, such as in a dashboard page in your app.
When your app is uninstalled, the default site consent policy should be reset to its original state so that your app's changes don't continue to affect the user.
Apps that modify the policy need to share their app ID with the Wix team for uninstall flow handling so that Wix can remove your settings. Use the Wix Support Chatbot and mention:
"I have a cookie consent app that needs to be added to the list of apps that will update the default policy in case they're deleted."
This ensures that when your app gets uninstalled, Wix automatically resets the default policy to allow all types so users don't get stuck with a restrictive policy and no way to manage consent.
You may also want to manually revert these settings if users can disable the functionality of your app in your app settings. For example, if your app adds a cookie consent banner and the user turns it off.