For an overview of how Microsurveys work, first read this article about Understanding Microsruveys.

When configuring your Microsurvey, you will go through these steps:

  1. Select type

  2. Build stepsΒ 

  3. Choose Environments (coming soon)

  4. Select audience

  5. Set Recurrence

  6. Review and Publish

πŸ‘€ Microsurvey building is moving to the Chameleon Dashboard. You can check out the new flow in this video which includes an additional step, as well as the full configuration from the Dashboard. We will update this article with the complete new flow soon.

🏷 In this article, we'll go through the steps to:

Select Microsurvey type

Start building your Microsurvey from the Chameleon Builder, by selecting the star icon. Then click New Microsurvey.

At this point, you can select the type of Microsurvey you'd like to build. Microsurvey types have fixed response components (e.g. 'NPS' has buttons for 0-10, while 'Input' has only a free-form text option etc.). Read more about the different types here.Β 

πŸ‘€ With the new UI you will build and choose your Microsurvey type from the Dashboard.

Build your Microsurvey

After selecting the type, you will see the "Microsurvey step" and you can configure it using the Builder Control Panel.Β 

πŸ‘€ With the new UI, after you pick a survey type, you can add all your Microsurvey steps from the Dashboard and customize them in the Builder.

You can click directly on the components of your Microsurvey (e.g. buttons, text, dismiss) to start editing them. You can also edit them through the Control Panel.

Design options:


Arrange where the Microsurvey should be positioned relative to the screen


Define the width of the Microsurvey, corner radius, opacity, and background color.


Add custom text and define its color, formatting, font size, and add any personalization options.


Add a custom image, GIF, or video to your Microsurvey.


Add a shroud that darkens the screen to highlight your Microsurvey.

Custom CSS

Apply custom CSS to further style your Experiences and update borders, line spacing, positioning, color gradients, and fonts.


Choose a Cross or custom Text dismiss, and define its position within or outside of the Microsurvey, as well as its color, size, and whether it should fully exit the Microsurvey or snooze it.


These options vary per each Microsurvey type, but generally allow color and label customization.

Display Rules:

Entry animation

Set an animation for when your Microsurvey first appears on the screen.

On-page Trigger

Select an element on the page which must be hovered or clicked on in order to trigger the Microsurvey. You can also append an icon or upload a custom image.

URL Rules

Define on which URL(s) this Microsurvey should appear.

Element Rules

Define which element(s) should be present or missing in order for this Microsurvey to appear.

Note: Upon configuring your Microsurvey, you should always Preview it from the Chameleon Builder, to view how it will look and behave for your end-users.

Configure Comments step

After configuring this Microsurvey step, you can add a free-form text input -- the Comments step -- and a Thank You step. You can do this directly from the top bar or from the Builder's sidebar.

πŸ‘€ With the new UI, you will be able to add and pick individual Microsurvey steps from the Dashboard and further customize them in the Builder.

Within the Comments step, you can ask a specific question based on how a user responded in the Microsurvey step, and collect qualitative feedback. The styling and position of the Comments and Thank You steps will match that of the Microsurvey step.Β 

Once you have included the Comments step in a Microsurvey, you can customize the content of this for each different answer of the Microsurvey step. For example, you may want to ask different questions depending on whether a user answered the Microsurvey step positively or negatively.

You can customize the following items:

  • Question copy

  • Placeholder copy

  • Button copy

  • Button label (text, emojis, numbers)

  • Button action (what happens when a user clicks this)

To do this, select the relevant tab in the Chameleon Builder corresponding to the answer in the Microsurvey step for which you want to customize the Comments step. You can then select any of the individual step components (by clicking on them directly) to further configure this.

To edit any Button on your survey Step, click on "Buttons" in your Control Panel and you can customize it by either clicking the Number in the Control Panel or by clicking the actual button on your Experience.

Here, is where you can also add Additional Actions to be launched when a user clicks any of the Experience buttons.

When added, the Thank You step will appear for users for 3 seconds (and automatically disappear) after they complete the previous Microsurvey/Comments step.Β 

πŸ’‘ Note: You can redirect users to a different page based on their button response within the Microsurvey step. Click the button to set up this redirect. In this case, you can decide not to include the Comments and Thank You steps.Β 

Choose an Environment to go live in

πŸ‘€ Coming Soon to all accounts: control where your Experiences are being displayed by adding different domains and subdomains to specific Environments.

This is very useful when building features that you want to move from, let's say a Staging space to a Production one. Or when you have multiple web pages that cater to different audience groups.

As the next step in your Microsurvey configuration from the Dashboard, you can pick the Environment where your Experience will be published on.

Select Target Audience

You can set for who the Microsurvey shows in the Target Audience section in the Builder sidebar.Β 

πŸ‘€ With the new UI, you can select your target audience after styling your Microsurvey, in the Dashboard.

You can create a Target Audience using the data you send to Chameleon, using the default Chameleon data, or any data received from integrations.

πŸ‘‰ Explore how to set-up a Target Audience

Note: You can use the Actions panel to define in which pages the Microsurvey should show to set-up any triggers -- icon click, element hover, etc.

Set Recurrence

As the next step of your Microsurvey configuration, you can define a Microsurvey to repeat periodically. The Microsurvey will then repeat for users, as long as they appear inside your application after that period, and continue to match the Microsurvey rules and targeting conditions.Β 

πŸ‘€ With the new UI, you can select your target audience after styling your Microsurvey, in the Dashboard.

When Recurrence is set the Microsurvey will repeat after the set period, which begins after the user last completes/exists the Microsurvey.

πŸ‘‰ For example, if Nathan saw the NPS Microsurvey, set to repeat each half-year, Feb 1 and Janice saw it March 1, Nathan would see it again the next time they visit the app after Aug 1, and similar Janice after Sept 1.

If Rate Limiting causes the Microsurvey to be suppressed, then it will appear at the next available opportunity.

If the Recurrence is adjusted and the Microsurvey re-published, then the most recent Recurrence setting will be used.

πŸ’‘ Note: When creating a Target Audience based on a user's Microsurvey response, the most recent response will be used. However, all responses will be available within the Chameleon Dashboard to view or download.Β 

Going live

Once you've finished configuring your Microsurvey, you can activate it. To first test out the Microsurvey live, you can target just yourself and close the Builder to preview it live.

πŸ‘‰ Understand your options for testing Chameleon Experiences

Once the Microsurvey is live, you can edit it further, but you must always Apply edits before these changes are pushed live to users.Β 

Getting the data

All your Microsurveys' data will be available in your Chameleon Dashboard. You can download the data as a CSV and also connect your analytics tool to have the data automatically sent there.

πŸ‘‰ Know more about the different native integrations

Know more

Did this answer your question?