Smart Cookie Popup

How to add a cookie popup to a Wix Headless site

Add a GDPR cookie popup to your Wix Headless site with Smart Cookie Popup: install it with a ready-to-copy AI prompt, then turn it on. No code needed.

2 min read4 FAQsArticle 2 of 10

Building your site with Wix Headless? You can add a GDPR-ready cookie popup with Smart Cookie Popup, without writing any code for the banner. A Wix Headless site has no editor, so you can't drag the app onto a page. Instead, you install the app on the site and turn the popup on in its dashboard. The quickest way to install it is with an AI assistant that is connected to Wix.

What you need

  • A Wix Headless site. For example a site built with Wix's Astro integration, or a static site uploaded to Wix.
  • An AI assistant with a Wix connection, such as Claude with the Wix connector (Settings → Connectors → Wix).
  • A Wix account with access to the site. Sign in with that account when you connect Wix to your assistant.
  1. Open a new chat in your AI assistant.
  2. Copy the prompt below and replace [your site] with the name or address of your Wix Headless site.
  3. Paste the prompt and send it. The assistant finds your site, installs the app and checks that it is installed.
  4. Wait until the assistant confirms the installation.
Install the Smart Cookie Popup app on my Wix Headless site [your site].
App ID: ea171857-c45d-4dfe-889c-e05e8e9a7662
Use the Wix Apps Installer API to install it, then check that it appears in the site's installed apps and tell me if it worked.

The prompt includes the app ID of Smart Cookie Popup. With the ID, the assistant installs exactly this app instead of searching the App Market, where it could pick a different cookie app with a similar name.

Open your site's dashboard in Wix, go to Smart Cookie Popup and turn the popup on. From then on it loads on the pages of your headless site by itself: you don't add any code to your project.

Next, set up the texts, colours and cookie categories of your popup. Getting Started With: Smart Cookie Popup for Wix walks you through the settings.

Step 3: Check your site

Open your site in a private browser window. The cookie popup appears on the first visit. Changes in the Wix dashboard can take up to 10 minutes to show up on your site.

Hosting your headless frontend yourself?

On a self-managed headless project, your pages need Wix's site script: one script tag that loads the scripts of your Wix project, such as analytics, the consent policy and app scripts. Sites built with Wix's Astro integration and static sites uploaded to Wix already include it. See Load Site Scripts on a Self-Managed Project in the Wix docs.

Frequently asked questions

How do I add a cookie popup to a Wix Headless site?

Install Smart Cookie Popup on the site, for example with the AI prompt in this article, and turn the popup on in the app's dashboard. It then loads on the pages of your headless site by itself, without code in your project.

Does a Wix Headless site show a cookie banner by default?

Not with the default settings. On a new Wix Headless site the default consent policy allows every cookie category until you set a stricter policy, and Wix's own banner only appears when the policy requires one. Visitors in regions that require opt-in consent, such as the EU under the GDPR, need to be asked before non-essential cookies are used. A cookie popup does that.

Can I install a Wix app on a headless site without the Wix editor?

Yes. An AI assistant that is connected to your Wix account installs the app through the Wix API. You then manage the app from your site's dashboard, just like on any other Wix site.

Why does the prompt include an app ID?

With the app ID the assistant installs exactly Smart Cookie Popup. Searching the App Market by name can return other cookie apps with similar names.

Still need help?

Can't find the answer? Our support team is happy to help with Smart Cookie Popup.

EmailWhatsAppHelp docs