State Triggers Overview

State Triggers pair a URL pattern with one or more quick-action chip messages, so a widget can offer different prompts on different pages.

Caution

The widget does not apply State Triggers yet. It shows the quick-action chips set in its Settings tab on every page, whatever URL the user is on.

State Triggers are configured per widget — you add them on the Create Widget screen, scoped to the widget being created.

How State Triggers work

Each State Trigger has these parts:

1. URL pattern — The page address the chips are meant for. You can use an exact path, a substring (contains), or a wildcard (*). Examples: /pricing, /about, or https://example.com/contact.
2. Messages (chips) — One or more short prompts, each a tappable chip. At least one message is required.
3. Widget — The widget the trigger belongs to.

The rules are stored against the widget, but nothing matches them against the current page today — the widget shows the chips from its Settings tab on every page. See Widget Customization.

Adding a State Trigger

On the Create Widget screen:

1. In the State Triggers section, enter a URL Pattern.
2. Add one or more Messages — each is a chip. Use Add message for more than one.
3. Click Add State Trigger to stage it.
4. Repeat for additional patterns. Staged triggers are saved when you create the widget.

Pattern matching

The Create Widget screen accepts three pattern styles and stores whichever you type. What each is intended to match:

Style	Example	Matches
Exact	/pricing	Only the /pricing page.
Contains	settings	Any URL containing settings.
Wildcard	/checkout/*	Any URL under /checkout/.

You can also use a full URL (e.g. https://example.com/contact) when you want to match a specific absolute address.

What the rules are for

Once the widget applies them, each rule is a page-specific set of chips:

• Page-specific prompts — “Why was I charged twice?” on a billing page, “How do I reset my password?” on an account-security page.
• Funnel coaching — On checkout pages, prompts that answer common pre-purchase questions.
• Feature-area help — On a complex settings page, chips mapped to the most-asked questions for that surface.

State Triggers vs. Guides

State Triggers are about chips — short prompts the user can tap. Guides, which are Coming Soon, will be step-by-step walkthroughs instead. Neither is applied by the widget today; for end-to-end task instruction that works now, use the Widget’s Show mode. All of it is part of User Support.

Tip

Start with a State Trigger for one or two of your most-visited support pages — billing, account settings, or checkout — so the rules are ready when the widget starts applying them.