Demo Sites
Demo sites let you run any static HTML site through the MonetizationOS proxy worker, giving you a live preview of your experiences, offers, and workflows without needing to deploy a worker to your CDN.
Demo sites are for preview purposes only. The real site is never modified.
You can access your demo sites from the Demo Sites card on the dashboard, or by navigating to it directly and clicking 'See all sites'.
Demo Sites
The full demo sites list shows all of your configured sites. Each row displays:
- Demo URL: The proxied URL where the demo site is accessible, in the format
string-dev.mosproxy.dev - Origin URL: The original site being proxied
- Surface: The surface applied to the demo proxy
- Actions: Open the demo URL, or click the kebab menu (three dots) to delete the site
You can search for a site by subdomain or origin using the search bar.
To add a new demo site, click 'Add Demo Site'.
Adding a Demo Site
Adding a demo site is a two-step process.
Step 1: Surface and Origin
Surface
Select the surface you want to apply to this demo from the dropdown. The surface determines where your experiences appear on the page. A surface must already exist in your organization before you can use it here. If you have not yet created one, see our Surfaces guide.
Origin
Enter the site MonetizationOS will load and proxy. This is only available for static HTML sites.
If you do not have a site to use, you can select the MOS demo origin, which is a basic sample news site provided for testing purposes. Details for this site are available as a default input.
Once you have configured both, click 'Next'.
Step 2: Proxy Configuration
These settings tell the proxy how to recognize signed-in and anonymous visitors on the demo, so that access decisions behave as they would in production. The defaults work for most static sites.
Anonymous Session Cookie
Enter the cookie your site uses for anonymous sessions. If you are unsure, use the default: mos-demo-anon-session.
Signed-In User Cookie (Optional)
This is only needed if your demo will simulate logged-in user states. If required, enter the relevant cookie name. The default is _session.
Additional Settings (Optional)
If you are connecting to a real origin, you may need to configure additional settings for protected paths, routing, or custom headers. Click 'Additional Settings' to expand this section, where you can:
- Ignore paths: Paths the proxy will skip when making surface decisions
- Surface decision cookies: Specify any additional cookies used for surface decisions
- Origin request headers: Click 'Add Header' to add a custom header sent to your origin. Enter a header name and a hidden value (secret).
Once you have configured your settings, click 'Create Demo Site'.
Using Your Demo Site
After clicking 'Create Demo Site', a new tab will open while the site is being set up. Once ready, you will see your origin site served through the MonetizationOS proxy.
Any changes you make to your surface workflows, component workflows, plans, offers, or experiences will automatically propagate to your demo site. This makes it straightforward to preview your monetization configuration in context before creating a new version to deploy beyond your preview environment.