You can configure individual widget types, manage allowed domains and redirect URLs, customize your widget's appearance, adjust checkout behavior, and copy the code needed to embed your widget on your website.

To get started:

You'll see separate tabs for Domains, Ticketing, Add-Ons, Donations, Subscriptions, Email Opt-In, and Appearance. Use Save Changes at the bottom of the page whenever you update your Appearance settings.

The Domains tab contains settings that apply across your website widgets.

Add the domains where your On The Stage widget will be displayed.

Your website's domain must be included here for the widget to load correctly.

Troubleshooting tip: If your widget is blank or isn't loading on your website, check your Allowed Domains first and confirm that the correct domain has been added.

You can also configure redirect URLs for:

These settings determine where patrons can be directed during applicable widget and checkout experiences.

Each widget type has its own configuration tab:

Each tab includes a preview of the widget alongside the settings available for that widget type. Use the Desktop/Mobile toggle above the preview to see how your widget will appear on different devices.

The Ticketing tab includes options such as:

For Widget Style, you can choose from:

Calendar - Displays performances in a calendar-style format.

List - Displays available events in a list.

Gallery - Displays productions and performances using visual tiles.

Gallery mode also includes additional display options, including the ability to hide month labels and limit the number of tiles displayed.

Select the Appearance tab to customize your widget's visual style without needing to write custom CSS. As you make changes, you'll see a live preview of how your selections will look.

Start with one of the available design presets:

Selecting a preset updates the theme's colors, typography, and button styling. You can then customize individual settings to better match your website.

Use the color controls to adjust:

Theme Color - Used for header areas and highlights.

Primary Color - Used primarily for action buttons.

Secondary Color - Used for supporting accents.

Button Text Color - Controls the text displayed on action buttons.

Select your preferred font from the Typeface section.

If the font displayed in your widget doesn't match the font you selected, check that the same font has been loaded on your website.

Select from three button styles:

When you're happy with your changes, select Save Changes to apply your theme to your live widget.

Need more advanced customization?

Under the Appearance tab, expand Advanced: Upload Custom CSS.

Here you can upload and manage custom CSS stylesheets.

If you already have a custom stylesheet uploaded, you can view its status and choose to activate, download, or delete it.

If you've changed colors, fonts, or buttons using the Appearance settings but aren't seeing those changes on your live widget, check whether an uploaded custom CSS file is currently active.

Checkout-related options are managed separately from your individual widget settings. Navigate to: Website → Widget Configuration → Checkout Settings.

Cart Mode determines how patrons can add performances to their shopping cart.

Depending on your plan, available options may include:

Single Performance - Patrons purchase tickets for one performance at a time.

Single Production - Patrons can add performances from the same production to their cart.

Multicarting - Patrons can add performances from multiple productions to the same cart.

You can also choose whether patrons are required to provide their full mailing address during checkout. Turn on Require Mailing Address if you'd like this information to be required before a patron can complete their purchase.

Each widget configuration tab includes a Widget Code Snippet section.

Once you've configured your widget:

The current widget code uses a single combined snippet, so you don't need to install a separate script in your website header. If you're already using an older On The Stage widget embed, you don't need to replace it immediately. Existing widget embeds remain supported.

Only one On The Stage widget should be embedded on a single webpage.

If multiple widget embeds are added to the same page, the widget may display a warning while you're editing or previewing your website. If this happens, remove the duplicate widget code and leave only the widget you'd like displayed on that page.

You can still place different widgets on different pages of your website.

First, go to Widget Configuration → Domains and confirm that your website is included under Allowed Domains.

If your domain is correct, confirm that the complete Widget Code Snippet has been added to your website.

Go to: Widget Configuration → Appearance → Advanced: Upload Custom CSS

Check whether a custom CSS file is active. Active custom CSS overrides settings from the visual Appearance customizer. Also make sure you've selected Save Theme after making your changes.

Cart Mode is located under:

Website → Widget Configuration → Checkout Settings

Redirect URLs are located under:

Website → Widget Configuration → Settings → Domains

The Require Mailing Address setting is now located under:

Website → Widget Configuration → Checkout Settings

Gallery tiles use an encapsulated styling structure, so standard CSS from your website may not automatically affect all elements inside the Gallery widget.

For advanced styling needs beyond the Appearance customizer, contact On The Stage Support for assistance.