Get started

Install the script

Add one script tag to your site's head, first, before any other tag. Then publish your banner and check it works. The whole setup takes about five minutes.

allowedit runs from one script tag. You add it to your site once, and every change you make in the dashboard after that reaches your site without touching the code again.

Before you start

You need:

  • A free allowedit account. Create one here if you haven't yet.
  • A site added in your dashboard. You'll get a site id, which is part of your script URL.
  • Access to your site's <head>, through your theme, your platform's settings or Google Tag Manager.

If your site runs on WordPress, Shopify, Webflow, Wix or Squarespace, the platform guides in the sidebar show exactly where the tag goes. There is no allowedit plugin to install. It's a script tag, and that works on any platform that lets you add code to the head.

1. Copy your script tag

In your dashboard, open the site. The tag is on the Overview, under Install the banner. Copy it. It looks like this, with your own site id:

<script src="https://allowedit.com/c/<siteId>.js"></script>

2. Add it first in your head

Paste the tag into your site's <head>, above every other script. It must come before Google Tag Manager, the Google tag (gtag.js), the Meta Pixel and anything else that tracks visitors.

<head>
  <meta charset="utf-8" />
  <script src="https://allowedit.com/c/<siteId>.js"></script>

  <!-- Google Tag Manager, analytics and pixels go after it -->
  <script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXX"></script>
</head>

The script is small (under 10 KB gzipped), served from the edge and cached. It reads your banner settings from that cache, so a page view never waits on our database.

3. Publish your banner

The banner doesn't change on your site until you publish.

  1. In your dashboard, open the site, then Banner.
  2. Pick a layout (bar, box or modal), a position, your colours, corner radius and font. The preview updates as you go.
  3. Check the text in each language you want to offer. allowedit ships English, French, German, Spanish, Italian, Dutch and Portuguese, and picks one from the visitor's browser.
  4. Choose Publish.

Your published settings reach the edge within a minute or so.

4. Review your first scan

Your first scan starts as soon as you add the site. Open the Cookies tab to see what it found: the scanner visits your pages in a headless browser, before and after consent, and lists every cookie by category. Change any category you disagree with. Cookies it can't place wait under To review until you pick one. Scan now runs another scan whenever you like.

The cookie list feeds the preferences panel and your cookie declaration.

5. Check it works

  1. Open your site in a private window, so no earlier choice is stored.
  2. You should see the banner. Visitors in the EU, UK, Switzerland and Quebec see it with Accept all and Reject all buttons. Elsewhere, what they see depends on your region rules.
  3. Choose Reject all, then open your browser's developer tools. Under Application (or Storage), check Cookies: you should see allowedit_consent and no analytics or marketing cookies.
  4. Reload. The banner shouldn't come back.

If something looks wrong, see Troubleshooting.

Next steps

  • Verify your domain to turn on scheduled scans. The banner and consent log already work.
  • Using Google tags? Set up Google Tag Manager and Consent Mode.
  • Add a "Cookie settings" link to your footer so visitors can change their mind. Any link with href="#cookie-settings" opens the preferences panel:
<a href="#cookie-settings">Cookie settings</a>

Still stuck? Email support@allowedit.com with your site's address and what you see.