This article is for you if you meet any of the following criteria: 

The Chameleon Sidebar:

Don't see it? Read along to see what might help.

Basic checks

The first thing to do is to ensure:

  1. You are logged-in to the Chameleon website. Do so here.

  2. Chameleon is installed on the page you are attempting to view the Editor or you have the Chrome Extension loaded on this page.

  3. You have not hidden the Editor or entered "Test Mode" (you can check and reverse this by clicking on the Chrome Extension). 

If both of these are satisfied, then you can proceed with the following troubleshooting:


Let's find out if the Sidebar issue is being caused by Implementation or Authentication.

On the page, right click and select “Inspect Element.” Open the Console tab, and type chmln.

  1. If you get the result Uncaught ReferenceError: chmln is not defined, the snippet has not been implemented.

  2. If you get any result containing function, you are not authenticated or testing mode is on (turn off here).

  3. 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 still doesn't work: 

Grab a screenshot of your app with the JavaScript console open (scrolled to any errors that are related to 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 ' 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.

CSP issues

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.

Did this answer your question?