Rolling theme updates
Roll out a new widget theme with your own feature flag.
- Last reviewed
Rolling theme updates
Use this when your app is going through a rebrand and the widget theme should change at the same time as your own release.
Instead of switching the default theme for everyone, assign the new theme to a runtime feature flag. People who open a flow with that flag see the new theme. Everyone else keeps seeing your default theme.
1. Create the new theme
Open Settings → Theme and create or edit the theme you want to roll out. Keep your current production theme as the default until the release is ready.
2. Assign the theme to a flag
From the theme card, choose Switch to this theme. Turn on Rolling release, then enter the feature flag name and value your app will send at runtime.
For a simple on/off flag:
| Field | Value |
|---|---|
| Feature flag | rebrand_v2 |
| Value | true |
For a variant flag, use the variant value your app already uses, such as
treatment or new_brand.
3. Send the flag at runtime
Add the flag to the hosted page or iframe URL when your app is in the matching release state.
Hosted page:
https://getuserfeedback.com/s/SURVEY_ID/flag:rebrand_v2Iframe:
https://getuserfeedback.com/embed/YOUR_API_KEY/SURVEY_ID/flag:rebrand_v2If your flag has a variant value, include it after the flag name:
https://getuserfeedback.com/embed/YOUR_API_KEY/SURVEY_ID/flag:brand_rollout:treatmentReplace rebrand_v2, brand_rollout, and treatment with your own flag names
and values. The examples are arbitrary — use the same feature flag names your
app already uses for the rollout.
What good looks like
- Your app and the widget switch visual design in the same release.
- The default theme still protects people who are not in the rollout.
- The same flag works for hosted pages and iframe embeds.
What can break
If the flag is missing from the URL, the default theme is used. If the flag name or value does not match the theme assignment, the default theme is used.
For the full URL format, see Hosted pages or Iframe.