This article is for you if you meet any of the following criteria:
You're signed up for a Chameleon account
You installed the Chameleon extension or snippet on your page
You're expecting to see the sidebar (you've used it before) and it's no longer on the same page (URL)
Before we start...
The first thing to do is to ensure:
You are logged in to Chameleon.
Chameleon is installed on the page you are attempting to view the Builder or you have the Chrome Extension loaded on this page.
If both of these are satisfied, then you can proceed with the following troubleshooting.
Let's find out if the Builder sidebar issue is being caused by Implementation or Authentication.
On the page, right-click and select “Inspect Element". Open the Console tab, and type
If you get the result
Uncaught ReferenceError: chmln is not defined, the snippet has not been implemented.
If you get any result containing
function, you are not authenticated.
If you get any other result (an
Error) then please:
Check that your browser is not blocking 3rd party cookies. For Chrome you can read about how to manage exceptions (i.e. allow Chameleon to set cookies) here.
Check that any ad-blocking software is not interfering with the Sidebar loading. Try turning it off your ad blocker and refreshing the page to see if that could be the issue.
If this doesn't work:
chmln) and email us.
For a quicker resolution, please type
chmln.isEditing into the JS console and let us know the return value. Finally please check the
chmln-user-id cookie is present in the 'Application' tab (see below)
⚠️ NOTE: you must have the console open before you load the page for this to work (so just hit Refresh on the page after you've opened the console).
Fixing an implementation issue
Your personalized snippet can be found on your Dashboard. Follow the instructions to implement, after which you can click Build Tour from the Dashboard to open the Sidebar.
If after implementing, you see and error in your console that looks similar to
Refused to load the script 'https://fast.trychameleon.com... because it violates the following Content Security Policy directive, then see our notes about adding Chameleon to your Content Security Policy below.
Fixing an authentication issue
Go to your Dashboard and click Build Tour to open the Sidebar on your site.
If you are redirected to a login page when trying to load the Dashboard, this means you are logged out. Chameleon is passwordless, so authentication works via a login link enabled by cookies. Enter your email address on the login page to be sent a new authentication link. After opening this link, your Dashboard will load.
If this does not solve the issue, please email us and provide a login to your app so we can test as we resolve the issue.
If you know that your application has a Content Security Policy, or you see a CSP related error in the Chrome Extension or browser console, then Chameleon needs to be added to the list of trusted sources that can run on pages in your application. Learn more here.
Ensure third-party cookies are enabled on your browser
Chameleon's sidebar and tours require that you have third-party cookies enabled. This setting is commonly enabled by default on all browsers, but may have been manually disabled.
To enable third-party cookies in Chrome, navigate to chrome://settings/, scroll to "Privacy and security", click on "Content settings", then click on "Cookies", and finally switch "Block third-party cookies" to the Off position.