Skip to main content
Understanding Microsurveys

Learn how to use and configure Microsurveys for efficient user feedback

Tiago Mota avatar
Written by Tiago Mota
Updated over 3 weeks ago

Chameleon Microsurveys enable you to collect in-product feedback from your users without requiring additional coding or engineering time. You can create on-brand Microsurveys with custom questions triggered at the right time for your users.

πŸ‘‡ Check out an interactive demo on how to build a multi-button Microsurvey!

preview of a rating Microsurvey triggered on click

Availability & Usage

πŸ” Startup: 5 Microsurveys

πŸ” Growth & Enterprise: unlimited Microsurveys

πŸ“© Contact: to discuss your plan needs


What are the components of a Microsurvey?

Chameleon Microsurveys include up to three different Steps:

  1. Question Step: a question with a response option (different depending on the Microsurvey type you choose);

  2. Follow Up Step: an optional Step where users can share more insights. This Step can have two different questions (e.g., an input and a multi-button choice); the question and placeholder text can be updated based on which button the user clicked in the Question Step.

  3. Thank you Step: an optional thank you message that displays briefly.


How to create a Microsurvey?

To create a Microsurvey, pick this Experience type from the Dashboard's left-side menu and click "+ Create a Microsurvey".

πŸ‘‰ You can also create a new one from your Homepage - just click the "+ New Experience" button at the top-right corner and select Microsurveys.

Let's cover the configuration flow together.

Step 1: Select a Microsurvey Type

This sets the format and specific options for the Microsurvey Question Step. Each type offers different customization options (e.g., a CES Microsurvey has a choice of emojis, numbers, text, etc.) and reporting (e.g., an NPS Microsurvey requires a different analysis than a CSAT).

Once you pick a type, the others will be locked, and you won't be able to switch types. This keeps your data clean and responses organized. πŸ˜‰

Step 2: Build your Microsurvey in the Chameleon Builder

In the next panel, start building your Microsurvey by picking a style: aΒ TemplateΒ or a blank canvas (that uses yourΒ Brand Styling). Then, enter the Builder in your application to configure each Microsurvey Step.

πŸ‘‰ You can add a Follow Up Step and/or a Thank You Step from the Dashboard or enter the Builder and add them from the Builder Topbar. In the Builder, switch between these Steps to edit the content in each one.

These are the options you can set using the Builder:

  • Where the Microsurvey should be positioned, and how it can be triggered or dismissed by users.

  • Set specific Element or URL Rules needed for the Microsurvey to display to users.

  • Adjust the width of the Microsurvey Canvas, corner radius, opacity, and color.

πŸ‘‰ You can choose a manual or an auto option for the Canvas width. When set to auto, the Canvas size will adapt to fit the buttons in it. A manual Canvas also allows you to adjust the Canvas width for each Step individually, while the auto option will keep the same width for all 3 Steps in your Microsurvey.

  • Add Step level Custom CSS for styling tweaks

  • Add custom text to the Body and define its color, formatting, and font size, as well as personalization options

  • Add a custom visual - image, GIF, or video

  • Add a Shroud that darkens the screen to highlight your Microsurvey

  • Customize how buttons look and what "Actions" they can launch

πŸ‘‰ With Rating & Multi button Microsurveys, you can pick between a horizontal and a vertical button layout. Find these layout options under Styling in the Builder.

β„Ή For a better end-user experience, the styling you set on the Question Step will remain consistent across all Steps. This includes the canvas color, text color, button alignment (vertical/horizontal), text alignment, and button styles.
​
​The same applies if you use a Shroud, for example. If you add it to the first Step, it will carry to the Follow Up and Thank you Steps as well. These options are available on the Microsurvey (first) Step and not subsequent Steps.

Step 3: Configure your Microsurvey's questions

Configuring your Question

There are two elements you can customize in your first Question:

  • The body: applying a bold or italic style, adding hyperlinks, or personalizing with user data

  • The response: customizing the type of input, adding labels, or adjusting the placeholder text

☝️ The "response" section in the Builder can have different options based on the Microsurvey you create, but the editing process is the same. You can click directly into the Builder component or the Builder section to edit either the body or the response in a Microsurvey Step. The Builder will always highlight the component you're about to edit.

Adding a Follow Up Step

If you want, you can add a Follow Up step to your Microsurvey. Similar to the main Question step, on the Follow Up, you can also customize:

  • The body: applying a bold or italic style, adding hyperlinks, or personalizing with user data and customizing the copy for different responses.

  • The type: picking a type and adjusting its specific options, such as the labels, allowing for an "Other" option, picking an input type, or personalizing the placeholder text with user data.

πŸ‘‰ In Follow-up Steps, you can set if the response should be mandatory or optional. Select any Question and find this option in the 'Question Type' section.
​

How Follow-Up Steps Work

When you create a Follow-Up Step, it automatically includes all responses from your first Question Step. This powerful feature lets you tailor your message for each possible answer! For example, you may want to ask different questions depending on whether a user answered the first Microsurvey Step positively or negatively.

Customizing Your Messages

You have two ways to personalize your follow-up messages:


​1. Individual Response Messages

  • Open the Builder

  • Select a specific response group

  • Customize the message for that particular answer


​2. The same message for all responses

  • Use the "All Responses" option

  • Make changes that apply to every response at once

Example Scenario

Let's say you're asking users about their experience with a new feature:

  • For users who respond positively, you might ask: "What feature would you like to see next?"

  • For users who respond negatively, you could ask: "How can we improve this feature for you?"

This approach ensures each user receives relevant follow-up questions based on their initial feedback, creating a more meaningful conversation.

πŸ‘‰ For Input and Dropdown Microsurveys, you can adjust the button position on the Question Step or add an Action by selecting it in the Builder.

Question types on Follow Up Steps

On all Follow Up Steps, you can pick out of 4 question types:

  • Rating

  • Multi button

  • Input

  • Dropdown

This way, you can essentially mix together any type of Microsurvey in Chameleon to collect insights from users.

Response logic

In "Response Logic", you can control which questions your users see based on their responses, creating a more personalized survey experience. To do that:

  • Navigate to your Follow-Up Step

  • Open the Response Logic panel

  • Use the toggle switches to enable or disable questions for specific responses

When you disable all questions for a response, users will automatically move to the "Thank you" Step or exit the Microsurvey.

πŸ’‘ Always test your response paths to ensure each user journey flows smoothly.

Step 4: Launch powerful Actions

You can add up to 2 buttons to all Microsurvey Follow Up Steps, each of which can launch dynamic Actions once users click them. This is powerful for driving users' discovery, providing further help, or easily engaging them with specific guides.

Actions can launch other in-product Experiences, your integrations, or update data in your account. For example:

  • πŸ“ You can launch a Typeform survey to collect more detailed feedback or responses, including varying input options or logic based on responses.

  • πŸ•ΉοΈ Share Figma prototypes with power users and ask them to share feedback on upcoming features.

  • πŸ“† Schedule a call or meeting with a user (e.g. for product feedback or customer support, or sales) from inside your product using Calendly or Chili Piper.

ℹ️ The Input and Dropdown Microsurvey types support Actions on the first Question Step as well. Simply select the 'Submit' button, and add your desired Action.

Once you're done configuring your Microsurvey Steps, try using the "Preview mode" to test how it displays to end-users. Once you're happy with it, return to the Dashboard to pick an audience and publish your Microsurvey.

πŸ‘‰ Learn more about testing a Chameleon Experience to ensure your Experiences always display correctly.

Any changes you make in the Builder will be reflected in your Dashboard. In the Dashboard, you can also easily review all Step interactions by toggling on "Show interactions".

Step 5: Choose an Environment

If you have your Environments set, this is where you'll choose where you want your Microsurvey to appear. This is very useful when you have staging and production environments or when you have multiple web pages that cater to different audience groups.

πŸ‘‰ Read more about managing Experiences across different Environments, to learn how to effectively target your Microsurveys to specific groups of domains or subdomains.


Step 6: Choose a target audience

Next, select the Segment that should see your Microsurvey. You can search in the drop-down menu and combine multiple Segments or choose one of the pre-defined audiences created by Chameleon.

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

Step 6: Set the Recurrence

You can set a recurring cadence for your Microsurvey to display to users with Recurrence. Define how often a Microsurvey should repeatedly display to your users after it has been exited or completed.

Recurrence dropdown options 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, on Feb 1 and Janice saw it on March 1, Nathan would see it again the next time they visit the app after Aug 1, and similarly, Janice after Sept 1.

ℹ️ When creating a Segment 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.

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.


Step 7: Review and Publish

When you're done creating your Microsurvey, you have a few options to ensure you also deliver it at the right time. As the last step, in the 'Review and Publish' panel, you can choose to:

  • Publish immediately: Microsurvey is immediately live for all targeted users

  • Schedule publishing: set a date and time for Microsurvey to start being displayed.

  • Set end date: set a date and time to stop being shown to your users; the Microsurvey will switch to a Draft.

    • Unpublish after # responses: set a specific number of responses to trigger the Microsurvey to stop being displayed.

ℹ️ If you use both options, your Microsurvey will stop being displayed for whichever comes first -- the unpublish date you set or the number of responses.

Whenever you want to make changes to a live Microsurvey, you can easily do it from the Dashboard; don't forget to apply your changes from the Dashboard once you're done in the "Review and Publish" section.

πŸ‘‰ If your Microsurvey isn't showing up as expected, use the Debugger console tool to see detailed information about its settings and quickly solve the issue.


Chameleon automatically collects all user responses, along with analytics around the display and completion of your Microsurveys. This is available in the Chameleon Dashboard, via our API, via CSV download, and also directly to analytics integrations, including Slack.

All your Microsurveys data will be available on your Chameleon Dashboard. From here, you can download the data as a CSV and also connect your analytics tool to have the data automatically sent there.

Find all responses for each Microsurvey on the "Analytics" page in your Dashboard. Here you have a few useful options to efficiently review user feedback:

  • download all responses

  • filter responses

  • summarize responses with AI - see the summary on the Activity feed

You can leverage your Microsurvey data to target users with other in-app Experiences. When creating a Segment, you can use survey data to filter out users based on specific actions or responses.

This is powerful for connecting user responses to other in-product experiences and continuing to guide and engage your users.

You can also leverage our API to delete responses; here's a quick video walking you through the steps πŸ‘‡


Can I trigger other Experiences using Microsurvey data?

Can I collect free-form feedback using Microsurveys?

Can I show an on-demand Microsurvey?

Yes, you can use Chameleon to show a Microsurvey on-demand.

Did this answer your question?