|
/ Documentation /Getting Started/ Connecting Your Site to SureCookie (Scanner Setup)

Connecting Your Site to SureCookie (Scanner Setup)

SureCookie’s cookie scanner runs on our servers and loads your site in a real browser to find the cookies in use. Before your first scan, you connect your site to that service once. Connecting verifies that you control the domain and links your site to the scanner, which also powers automatic categorization and compliance suggestions.

You only do this once per site. After connecting, you can scan anytime, and your consent banner, script blocking, and consent logging work whether or not a scan has run.

Before You Begin

Connecting happens over the public internet, so a few things need to be in place:

  • A publicly reachable site – Connecting won’t work on localhost, a private network, or a development domain such as .local or .test, or while the site is behind HTTP basic auth, maintenance mode, or a coming-soon page.
  • HTTPS with a valid SSL certificate – Verification fails on a self-signed or expired certificate.
  • A reachable REST API – SureCookie verifies your site through a request to /wp-json/surecookie/v1/ on your domain. If a firewall blocks that path, connecting can’t complete.

Connect During Onboarding

The setup wizard opens automatically the first time you open SureCookie after activating the plugin. Connecting is one of its steps.

  1. On the welcome screen, start the setup.
  2. On Connect Your Account, click Connect.
  3. Wait for the Connected to SureCookie confirmation, then continue to the scan step.
Connect your account to SureCookie.

If you skipped the wizard, you can connect from the scanner instead.

  1. Go to SureCookie → Cookie Manager.
  2. On the Connect to scan your website screen, click Let’s Get Started.
  3. Wait for the Connected successfully! confirmation.
Cookie scanning dashboard screen

Note: Until your site is connected, scanning is unavailable and SureCookie shows an Account not connected prompt.

What SureCookie Sends When You Connect

Connecting is a lightweight handshake, not a data transfer. SureCookie sends only:

  • Your site URL
  • The WordPress administrator email
  • The SureCookie plugin version

No page content and no visitor data are sent. As part of the check, SureCookie requests a one-time verification token from your site to confirm you control the domain. Once verified, a private credential is stored on your site and used to sign future scan requests.

Run Your First Scan

With your site connected, you’re ready to scan.

  1. Go to SureCookie → Cookie Manager → Manual.
  2. Under Select Pages, choose the pages to scan.
  3. Click Start Scan.

The detected cookies appear on the All Cookies tab, sorted into the Essential, Functional, Analytics, and Marketing categories.

Troubleshooting

  • The Connect button fails or you see “Account not connected” – SureCookie couldn’t reach your site to verify it. Confirm your site is public, served over HTTPS, and not in maintenance mode, then try again.
  • You see an HTTP 422 or registration error – Verification was blocked, often by a security plugin or firewall. See Fix a Stuck or Failed Cookie Scan.
  • You moved your site to a new domain – Connecting is tied to your domain. After a move, reconnect so SureCookie can re-verify and issue fresh credentials.

Next Steps

Once connected and scanned, review your cookie categories so your banner groups everything correctly. If a cookie you expected isn’t listed, see Why Some Cookies Aren’t Detected. If a scan won’t start or stalls, see Fix a Stuck or Failed Cookie Scan.

Was this doc helpful?
What went wrong?

We don't respond to the article feedback, we use it to improve our support content.

Need help? Contact Support
Table of Contents
Scroll to Top