Q: Can I install Candu on multiple domains?
Yes! You can install Candu on as many domains as you need. Just make sure to whitelist each domain in Settings > Workspaces. You may want to use separate Workspaces for different environments (staging vs. production) or different products.
Q: Do I need different installations for staging and production?
You can use the same installation script, but we recommend setting up separate Workspaces for staging and production. This lets you test content in staging before publishing to production.
Q: How do I find my Client Token?
Your Client Token is found in Settings > Workspaces > Access Keys. Each Workspace has its own unique Client Token.
Q: I installed Candu but don't see any content. What's wrong?
Check these common issues:
Is your domain whitelisted in Settings > Workspaces > Whitelisted Domains?
Is the script installed in the
<head>section or close to it? You can use the Candu Chrome Extension to verify installation status.Are there CSP errors in your browser console?
Have you published content and placed it on the page?
Is your content targeted to the correct URL?
Q: I'm seeing CORS or authorization errors. How do I fix this?
This usually means your domain isn't whitelisted or your site's security settings are blocking Candu. Go to Settings > Workspaces and add your domain (including https://). Try using a wildcard like https://*.yoursite.com to cover all subdomains. Clear your browser cache after whitelisting.
Q: What are CSP errors and how do I fix them?
CSP (Content Security Policy) errors mean your site's security settings are blocking Candu. Add these domains to your CSP allowlist: https://api.candu.ai/, https://cdn.candu.ai/, and https://media.candulabs.com/. Contact your developer if you're not sure how to update CSP settings.
Q: Does Candu work with Single Page Applications (SPAs)?
Yes! Candu fully supports SPAs with no extra configuration. Our SDK automatically detects URL and DOM changes, ensuring your content loads correctly as users navigate through your app, no page refreshes required.
Q: Is there any advantage to using the Candu install script vs. Google Tag Manager (no-code)?
It depends on your setup and preferences. Both options work well, but keep in mind that some ad blockers can prevent Google Tag Manager from running. If you’re embedding mission-critical content, we recommend installing Candu directly through the script for greater reliability.