Chameleon makes it easy to create, deploy and manage in-product user guidance. We are built for browser-based web applications, and rely on JavaScript to show the guidance. 

Each product is architected uniquely and are goal is to support all common technologies, but please refer to the items below to help ensure a successful implementation. For further questions, please email our technical support team.

Browsers

Chameleon supports all modern browsers, including Google Chrome, Mozilla Firefox, Apple Safari, Microsoft Internet Explorer (v11.0 and up) and Microsoft Edge, for showing users product tours. 

For building product tours, we recommend using Chrome. 

If you have users on old IE versions, you can select to not show them tours, by using our audience targeting / user segmentation functionality

If you believe that Chameleon is not rendering correctly or accurately on any browser, please send a screenshot to help@trychameleon.com and we'll try to resolve asap.

Mobile web and mobile apps

Chameleon DOES support mobile web; product guidance is responsive and will adjust as elements on your page move based on browser size. 

However, by default, Chameleon tours are turned off for browser width < 720px to allow you to intentionally opt-in to showing tours on mobile devices to your users. We find that in most cases our customers design tours for a web experience, but if you'd like your tours to be displayed on browsers < 720 px, simply email us and we'll enable this. 

At this stage, Chameleon does NOT support native mobile applications. However, you can still send usage data from your mobile apps to Chameleon, to allow you to target web users based on their mobile activity. To learn more about how to send user data, read this. <link to sending user data section>

Single-page apps (SPAs) and front-end frameworks

Chameleon DOES support SPAs and all common front-end frameworks (e.g. React, Angular, Ember, etc.) using our URL and element matching conditions. 

Chameleon requires an initial page load to identify users, but then polls regularly to check whether a tour should show based on changing criteria (page URL or user activity). There is no separate implementation work required for single-page applications. 

Chameleon supports common front-end frameworks out-of-the-box and does not require any special engineering work. Simply implement our JavaScript code snippet or integrate via Segment.com. Learn more about these options here.

Multiple products and environments

Chameleon DOES work if you want to use for different products (with different domains) or different environments. 

You simply install Chameleon in the same manner (using your same unique code snippet) across all these products and environments. You can then specify which step should show on which product / environment by configuring the URL within the "Trigger" section for that step. 

Any account-level styling and configurations for your Chameleon account will apply across all these domains. This includes the admins on your account being able to access tours. For billing, we will use the total uniquely identified users across all domains to calculate your total MAU count.

Dynamic URLs and multiple subdomains

Chameleon DOES support dynamic URLs (where parts of the URL change based on the specific user) and multiple subdomains (e.g. for your different customers) for your application.

You can use wildcard or regex matching to configure any step to a specific URL. You can also substitute any part of the URL with the specific user data, by using variables. This is akin to using merge tags to replace a part of a string with the specific content for that user. Learn more about how to use these here

You can use a similar approach to handle personalized subdomains. If you change your subdomains by customer name, then we encourage you to send this part of the URL as a company attribute. Learn more about this here.  

Iframes

Chameleon DOES support the use of iframes within your application, and you will be able to build tours across iframes. 

To ensure this works smoothly, please ensure that the Chameleon code snippet is implemented separately within each iframe component.

Anonymous users

Chameleon PARTLY supports anonymous (unidentified) users, but does NOT support aliasing (yet).

This is relevant when showing tours to users who are not logged in to your product, and therefore not identified. To enable this to work, you must identify that user using any UID (Chameleon does not show tours to any users without a UID) although this does not need to correlate with any actual IDs from your database or records. 

We do anticipate supporting automatic identification and aliasing of anonymous users soon, so email or message us if this is important to you!

Strict security standards

Chameleon takes security very seriously and we seek to continually improve our systems with the most cutting-edge techniques to guard against any attacks or unauthorized access. We use best-in-class cloud services (such as AWS, Heroku, Compose) and serve over HTTPS using 256 bit SSL encryption. You can read more about our practices here.

Chameleon does not collect any personally identifiable data by default (we track user agent, IP address and URLs). We store any data you send to us (including from events that you define within Chameleon) but are NOT currently HIPAA certified. 

If your application contains a "Content Security Policy" (CSP) (to limit which third-party code may be executed on the pages of your application) then you must whitelist our domains to enable Chameleon to function. Read more about how to do this here.

Multilingual support

Chameleon PARTLY supports multiple languages; you are able to manually duplicate tours for different languages and target them to native speakers, but we do NOT offer automatic translation / localization services (yet). If this is important to you, please let us know how you would like to see this work by emailing us.

Did this answer your question?