Skip to main content
All CollectionsGetting StartedBefore using Chameleon
Will Chameleon work with my product?
Will Chameleon work with my product?

Learn more about how we handle the technology you may use in your application.

Chameleon Team avatar
Written by Chameleon Team
Updated over a week ago

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

We are aware that each product is architected uniquely and our goal is to support all common technologies. We work with customers with diverse products and we support a wide range of technologies, including SPA, or mobile web applications. Explore how our customers succeed with Chameleon from our Case Studies.

Please refer to the guide below to help ensure a successful implementation on your application.


Chameleon fully supports JavaScript web application frameworks. This includes (but is not limited to) the following:

Supported Frameworks

Including

Exceptions (Notes)

  • โ€  interface change events, interaction events, and highlighting/dynamic-positioning based on elements is not available.

  • Angular*

  • React*

  • ReactJS

    • Wrapped in Cordova

    • Wrapped in Ionic Capacitor

  • * NOT supported if itโ€™s a native app

  • ^ Contact us for more information

  • iFrames built by you within your application

  • 3rd party iFrames need Chameleon snippet installed within the iFrame to display Experiences within them

Shadow DOM

N-level deep Shadow DOM is supported

๐Ÿ‘‰ Learn more about how we work with Electron/Cordova apps.


If you would like to discuss your framework, feel free to contact us:

๐Ÿ‘‰ You can explore our interactive demos before installing, to learn how we handle element selection, display control, and more, to help you deliver contextual in-app Experiences.


Additional Details about Supported Frameworks

Mobile Compability

Mobile web applications

Chameleon fully supports mobile web applications. Our Experiences are built to be responsive and will automatically adjust as elements on your page move based on browser size.

Native mobile applications

At this time, Chameleon does not support native mobile applications. However, you can use our OneSignal and Zapier integrations to sync Chameleon data and trigger messages and push notifications on mobile devices.

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

Chameleon supports SPAs and all common front-end frameworks (e.g. React, Angular, Ember, Vue, etc.) out of the box and does not require any special engineering work. Simply implement our JavaScript code snippet or integrate it via Twilio Segment.

How it works with SPAs

Chameleon requires an initial page load to identify users and then polls regularly to check whether an Experience should display based on changing criteria such as page URL or user activity. No separate implementation work is required for SPAs.

Multiple products and environments

You can use Chameleon with different products or on different Environments (with different domains). Install Chameleon using your same unique code snippet across all these products and environments, then choose which environment(s) to display each Experience on when building.

โ„น๏ธ For billing, we will use the total uniquely identified users across all domains to calculate your total MTU count.

Dynamic URLs and multiple subdomains

Chameleon supports dynamic URLs 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, and substitute parts of the URL with specific user data using variables.

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.

iFrames

Chameleon allows you to build Experiences across any iFrames in your application. For optimal performance:

  • Implement the Chameleon code snippet separately within each iFrame component

  • Load iFrame content from the same subdomain as the top-level page when possible

  • Ensure the iFrame element does not use the sandbox attribute


Other supported features

Anonymous users

Chameleon partially supports anonymous (unidentified) users, but does not yet support aliasing.

To show Experiences to users who are not logged in to your product, you need to identify this user by using any UID, even if it doesn't correlate with actual IDs from your database.

โ„น๏ธ We do anticipate supporting automatic identification and aliasing of anonymous users soon, but drop us an email 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.

Learn more about our most recent security updates and future plans:

Chameleon prioritizes security with:

  • SOC II compliance since 2022

  • Best-in-class cloud services (AWS, Heroku, Compose)

  • HTTPS with 256-bit SSL encryption

  • No collection of personally identifiable data by default

Chameleon does not collect any personally identifiable data by default. We store any data you send to us (including from events that you define within Chameleon) but weโ€™re 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 add our domains to your allowed list to enable Chameleon to function correctly.

Multilingual support (Localization)

Chameleon supports multiple languages in two different ways:

  1. By duplicating Experiences and targeting them based on language.

  2. Using liquid logic to pipe in variable content for each user and displaying that in the same Experience.


Browser Compatibility

Supported browsers for viewing Experiences

Chameleon supports all modern browsers for displaying product Experiences to your users, including:

  • Google Chrome

  • Mozilla Firefox

  • Apple Safari

  • Microsoft Edge

Browser requirements for building Experiences

You will need to use Google Chrome to access the Builder via a Chrome Extension when creating your Experiences.

Compatibility target

Our minimum compatibility target is Chrome 110 and equivalent browser versions (released February 2023).

Internet Explorer support

We have discontinued active support for Internet Explorer following Microsoft's end of support. While Experiences may still display on IE, we cannot guarantee full functionality.

Excluding IE users:

If your user base includes Internet Explorer users, you can exclude them from seeing Experiences by using our audience targeting/ segmentation functionality.

โš ๏ธ If you think Chameleon is not rendering correctly on any specific browser, please send us a screenshot so we can take a deeper look into the underlying issue.

Did this answer your question?