Frequently asked questions about CookieShift — installation, scans, banners, AI, billing, and integrations.
Answers to the most common CookieShift questions. For step-by-step fixes, see Troubleshooting.
Getting started
How long does onboarding take?
Most teams complete first setup in under an hour: add a property (5 min), install the script (10–30 min depending on CMS), run a scan (5–20 min crawl), and configure Consent Setup (15–45 min with legal review). Enterprise rollouts with many domains take longer.
Do I need a developer?
You need someone who can paste a script tag or install a plugin once. Day-to-day banner edits, scans, and reports are no-code in the dashboard. Complex SPAs or custom tag managers may need engineering for optimal placement.
Can I manage multiple websites?
Yes. Each domain is a separate property under Websites. Switch properties from the header selector. Plan limits may cap how many domains you can add—see Billing.
Installation & banner
Why is my banner not showing?
- Confirm the Modules snippet is on the production site (view page source).
- Check connection status is Connected in Modules.
- Save in Consent Setup for the correct property.
- Clear CDN or WordPress cache plugins.
- Test in a private window without ad blockers.
Banner looks different than the dashboard preview
The preview matches the production banner runtime. Differences usually mean: wrong property selected when saving, cached HTML, or an old script URL. Hard-refresh and verify data-id in the snippet matches your property ID in Modules.
Do I need to update the script after every banner change?
No. Install the snippet once. Design and copy changes apply after you Save in Consent Setup.
What is the difference between Accept, Reject, and Customize?
Accept records consent for categories your configuration allows (depends on law mode). Reject declines non-essential categories where enabled. Customize opens the preference center so visitors choose per category. Button visibility is set under Appearance → button layout.
Scanner & trackers
Why does scan stay on “in progress”?
Large sites take longer. Wait 15–30 minutes. If it never completes, the site may block crawlers, require login for all pages, or hit rate limits—try a smaller max page count in enterprise scan settings or contact support.
Why does Scanner show cookies my browser extension does not?
The crawler visits multiple pages and may detect tags loaded only on certain URLs or after delayed execution. Extensions only see your current tab. Neither replaces the other—use scans for inventory, browser tools for spot checks.
What is “Unclassified” and why does it matter?
Trackers without a clear category appear as Unclassified. High unclassified counts raise Elevated risk in Scanner and lower compliance scores. Override categories in Tracker Inventory or fix via AI classification after a completed scan.
Scan vs live consent—what is the difference?
Scanner shows what the crawler found on pages. Consent logs show what visitors chose on your live banner. Both are needed: inventory proves what exists; logs prove what was allowed.
Compliance & legal
Does CookieShift guarantee GDPR compliance?
No software can guarantee legal compliance. CookieShift helps you discover trackers, configure consent UX, and document decisions. Always have qualified counsel review your banner text, policies, and data processing.
What is the compliance score on the Dashboard?
A scan-derived heuristic from risk level and open issues—not a legal certificate. Use it to prioritize fixes; do not present it to regulators as official proof.
Where do I export proof for an audit?
Use Compliance → Download PDF/CSV, Scanner → Compliance Issues exports, and Reports → Consent logs → audit export. Align date ranges with the audit period.
AI features
Why are AI tools disabled?
Most AI features require a completed scan for the selected property. Finish Scanner first, then refresh AI Assistant.
What counts against my AI token limit?
Assistant chat, banner generation, compliance checks, translation drafts, and auto-classification consume tokens. AI Usage breaks down consumption; BYOK usage may show separately.
Can I use my own OpenAI or Gemini API key?
Yes on supported plans. Configure AI Settings → Use my own AI provider, enter the key, and Test connection. You are responsible for provider billing and key security.
Is AI-generated policy text legally valid?
Treat it as a draft only. Lawyers must review before publishing. The product displays disclaimers for this reason.
Translations
Why did translation draft fail?
Common causes: no English (en) source strings in Consent Setup, AI quota exhausted, or missing property selection. Add English copy first, then Request AI draft on Translations.
What happens when I approve a translation job?
Approved strings merge into your property configuration for that locale. Visitors with matching browser language may see the new copy depending on language detection settings.
Billing & plans
How do I upgrade or change plans?
Open Billing, choose a plan card, select Stripe or PayPal if offered, and complete checkout. Use Manage payment methods for card updates.
What happens when I hit scan or AI limits?
New scans or AI requests may block until the billing period resets or you upgrade. Billing shows meters; AI Usage shows token details.
WordPress, Shopify, React
WordPress: connected but dashboard is empty
Re-save the plugin connection, confirm the domain in Websites matches the public URL, and run a scan from the dashboard. Clear caching plugins.
Shopify: OAuth failed
Ensure the Shopify store domain matches the property (.myshopify.com). Retry Connect Shopify from Modules with the correct property selected.
React SDK vs script tag?
The script tag works on any site. The React SDK wraps the same runtime for component-based apps. Pick one install method per property—do not double-load.
Team & account
How do I invite teammates?
Settings → Team Permissions (when enabled on your deployment). Enter email and role (Admin, Analyst, Viewer, Support). Some environments show “coming soon”—contact support for multi-seat setup.
Forgot password / Google sign-in only
Password users: use Forgot password on login. Google or Microsoft users manage passwords through their identity provider; link is shown read-only under Account.
Still need help?
Open Help Center from the profile menu in the dashboard or see Troubleshooting.