To ensure an even more contextual delivery to your users, you can time your Chameleon Experiences to your brand efforts. Use our scheduling feature to control exactly when your Experiences should start displaying or stop appearing to your users.
Availability & Usage
đ Available for all plans
đ Ready to power your Tours, Embeddables Microsurveys
âď¸ Use it from the Dashboard
How can I schedule Experiences?
Creating an Experience and setting it up for success are two different things. Scheduling is a core activity in your configuring workflow.
As you build your Tour or Microsurvey from the Chameleon Dashboard, access the Scheduling options in the final step of your configuration, under âReview & publishâ. With each Experience, youâll find helpful options to control how to display it to your users.
With Tours and Embeddables, youâll have a few core options when controlling the display time:
Publish it right away.
Schedule it to go live at a custom date in the future.
Set it to be displayed forever.
Unpublish it at a custom date in the future.
âš Chameleon uses the time zone from your browser when scheduling. You can confirm the scheduled time and time zone are correct after scheduling by returning to the Review & publish section.
đ Once you've scheduled a Tour, Microsurvey, or Embeddable, you can also read those dates through the REST API, as scheduled_publish_at and scheduled_unpublish_at. Both are read-only, so you can see a pending schedule but can't set one through the API. Each one clears once its schedule fires, so the API only shows schedules that haven't happened yet. This isn't available for Launchers or Tooltips.
For Microsurveys, youâll have a key action to help hone in the right feedback: unpublishing after receiving a specific number of responses.
To make sure you keep the feedback high-signal use the unpublishing option to cover just the right amount of respondents for you. Confirm when you have everything set and get back to your day!
Once you've configured your Experience display life, you will also see a confirmation on top, next to its name.
How to get the best out of Scheduling?
Scheduling Experiences helps you save time while coordinating in-product adoption efforts. Here's some advice from us to get you started:
Align your Experiences with active promotions, campaigns, or new feature launches.
Control the relevancy of your content by always aligning it to your product roadmap.
Can I retrieve an Experience's scheduled dates via the API?
Yes. The public REST API includes scheduled_publish_at and scheduled_unpublish_at in the response for Tours, Microsurveys, and Embeddables, so you can check a pending schedule programmatically â useful for tracking when a time-bound campaign is set to go live or come down.
âš These fields are read-only, and only ever report a pending schedule â once the date fires or the schedule is canceled, the field clears, so it can't be used as a record of when something happened in the past. Launchers and Tooltips don't support scheduling, so they won't return these fields.
â ď¸ If the teammate who set a schedule can no longer publish Experiences when the date arrives (for example, they were removed from the team or their role changed), Chameleon doesn't publish or unpublish the Experience. It clears the scheduled date instead and emails your Admins and Publishers. A scheduled publish is also cleared if something blocks it from going live. So if you check schedules through the API, a cleared date on its own doesn't confirm the change happened. Check whether the Experience is live too.