URL Triggers

Overview

URL triggers allow you to open specific modals and initiate user flows by adding query parameters or hash fragments to any page URL. This feature enables deep linking to authentication flows, subscription purchases, and account management screens.

Basic examples:

Query parameter: https://yoursite.com/?view=login
Hash fragment: https://yoursite.com/#view=login NEW

Both formats are supported. Query parameters take precedence if both are present in the same URL.

Hash Fragment Support `NEW`

URL triggers now support hash fragments (#view=...) as an alternative to query parameters (?view=...). This provides additional flexibility for single-page applications and specific use cases.

Key Features

🆕
Multiple Format Support:

Query parameters: ?view=login&plan_id=456

Hash fragments: #view=login&plan_id=456 NEW

Query parameters take precedence over hash fragments

🆕
Dynamic Re-triggering: NEW Hash-based triggers support dynamic re-triggering without page reload through the hashchange event. This is particularly useful for single-page applications (SPAs) where you want to trigger modals multiple times without full page refreshes.

🆕
Automatic Hash Cleanup: NEW After processing hash-based triggers, the hash parameters are automatically cleared from the URL. This enables re-triggering the same view by changing the hash again.

🆕
Mixed Format Support: NEW Parameters can be combined within the hash fragment using the same query string syntax:
https://yoursite.com/#view=plan-select&product_id=123&plan_id=456

When to Use Hash Fragments vs Query Parameters

Use hash fragments when:

Building single-page applications (SPAs) that need dynamic modal triggering
You want to trigger the same modal multiple times without page reload
You need to avoid server-side processing of the trigger parameters
Working with client-side routing frameworks

Use query parameters when:

Building traditional multi-page applications
You need server-side access to trigger parameters
SEO considerations are important for the triggered content
You want the most straightforward implementation

Available Triggers

Trigger	Hash Alternative `NEW`	Description	Parameters
`?view=login`	`#view=login`	Opens the login modal	—
`?view=register`	`#view=register`	Opens the registration modal	`plan_id`
`?view=plan-select`	`#view=plan-select`	Opens subscription plan selection	`product_id`, `plan_id`, `is_gift`
`?view=password-forgot`	`#view=password-forgot`	Opens the forgot password modal	—
`?view=password-reset`	`#view=password-reset`	Opens the password reset modal	—
`?view=password-change`	`#view=password-change`	Opens the password change modal (requires authentication)	—
`?view=passwordless-request`	`#view=passwordless-request`	Opens passwordless login request	—
`?view=passwordless-login`	`#view=passwordless-login`	Completes passwordless authentication	`token` (required)
`?view=email-verify`	`#view=email-verify`	Verifies email address	`token` (required)
`?view=user-edit`	`#view=user-edit`	Opens user profile editor	—
`?view=address-create`	`#view=address-create`	Opens address creation modal	—
`?view=payment-method-update`	`#view=payment-method-update`	Opens payment method editor	`source_id` (int), `list`
`?view=newsletter`	`#view=newsletter`	Opens newsletter subscription modal	—
`?view=newsletter-update`	`#view=newsletter-update`	Opens newsletter preferences editor	`email`
`?view=gift-redeem`	`#view=gift-redeem`	Opens gift redemption modal	`gift_code`
`?view=invoice-details`	`#view=invoice-details`	Opens invoice details	`id` (required)
`?view=manage-members`	`#view=manage-members`	Opens subscription member management	`subscription_id` (required)
`?view=cart`	`#view=cart`	Opens shopping cart	`sku_id`
`?view=order-create`	`#view=order-create`	Starts e-commerce checkout	`sku_id`

Use Cases with Examples

Direct Subscription from Marketing Campaigns

Query parameter: https://yoursite.com/?view=plan-select&product_id=123&plan_id=456
Hash fragment:   https://yoursite.com/#view=plan-select&product_id=123&plan_id=456  ← NEW

Gift Subscription Promotion

Query parameter: https://yoursite.com/?view=plan-select&product_id=123&plan_id=456&is_gift=true
Hash fragment:   https://yoursite.com/#view=plan-select&product_id=123&plan_id=456&is_gift=true  ← NEW

Gift Code Redemption Links

Query parameter: https://yoursite.com/?view=gift-redeem&gift_code=HOLIDAY2024
Hash fragment:   https://yoursite.com/#view=gift-redeem&gift_code=HOLIDAY2024  ← NEW

Email Verification from Transactional Emails

Query parameter: https://yoursite.com/?view=email-verify&token=abc123xyz
Hash fragment:   https://yoursite.com/#view=email-verify&token=abc123xyz  ← NEW

Passwordless Login from Magic Link Emails

Query parameter: https://yoursite.com/?view=passwordless-login&token=xyz789abc
Hash fragment:   https://yoursite.com/#view=passwordless-login&token=xyz789abc  ← NEW

Pre-filled Shopping Cart from Promotions

Query parameter: https://yoursite.com/?view=cart&sku_id=32,33,34
Hash fragment:   https://yoursite.com/#view=cart&sku_id=32,33,34  ← NEW

One-click Checkout for Single Products

Query parameter: https://yoursite.com/?view=order-create&sku_id=33
Hash fragment:   https://yoursite.com/#view=order-create&sku_id=33  ← NEW

Invoice Links in Billing Emails

Query parameter: https://yoursite.com/?view=invoice-details&id=999
Hash fragment:   https://yoursite.com/#view=invoice-details&id=999  ← NEW

Team Management from Admin Notifications

Query parameter: https://yoursite.com/?view=manage-members&subscription_id=555
Hash fragment:   https://yoursite.com/#view=manage-members&subscription_id=555  ← NEW

Update Payment Method from Failed Payment Emails

Query parameter: https://yoursite.com/?view=payment-method-update&source_id=123
Hash fragment:   https://yoursite.com/#view=payment-method-update&source_id=123  ← NEW

Newsletter Preference Center Links

Query parameter: https://yoursite.com/?view=newsletter-update&[email protected]
Hash fragment:   https://yoursite.com/#view=newsletter-update&[email protected]  ← NEW

Login Prompts on Gated Content

Query parameter: https://yoursite.com/?view=login
Hash fragment:   https://yoursite.com/#view=login  ← NEW

Registration Links in Marketing Materials

Query parameter: https://yoursite.com/?view=register
Hash fragment:   https://yoursite.com/#view=register  ← NEW

Password Reset from Support Interactions

Query parameter: https://yoursite.com/?view=password-forgot
Hash fragment:   https://yoursite.com/#view=password-forgot  ← NEW

Campaign Attribution Tracking

Query parameter: https://yoursite.com/?view=plan-select&product_id=123&plan_id=456&campaign_key=SUMMERPROMO
Hash fragment:   https://yoursite.com/#view=plan-select&product_id=123&plan_id=456&campaign_key=SUMMERPROMO  ← NEW

Legacy Aliases

For backward compatibility, these aliases are automatically converted:

Legacy	Hash Alternative `NEW`	Converted To
`?view=select`	`#view=select`	`plan-select`
`?view=redeem`	`#view=redeem`	`gift-redeem`
`?view=address`	`#view=address`	`address-create`

URL Triggers

URL Triggers

Overview

Hash Fragment Support `NEW`

Key Features

Multiple Format Support:

Dynamic Re-triggering: `NEW` Hash-based triggers support dynamic re-triggering without page reload through the `hashchange` event. This is particularly useful for single-page applications (SPAs) where you want to trigger modals multiple times without full page refreshes.

Automatic Hash Cleanup: `NEW` After processing hash-based triggers, the hash parameters are automatically cleared from the URL. This enables re-triggering the same view by changing the hash again.

Mixed Format Support: `NEW` Parameters can be combined within the hash fragment using the same query string syntax:

When to Use Hash Fragments vs Query Parameters

Available Triggers

Use Cases with Examples

Legacy Aliases

URL Triggers

Overview

Hash Fragment Support NEW

Key Features

Multiple Format Support:

Dynamic Re-triggering: NEW Hash-based triggers support dynamic re-triggering without page reload through the hashchange event. This is particularly useful for single-page applications (SPAs) where you want to trigger modals multiple times without full page refreshes.

Automatic Hash Cleanup: NEW After processing hash-based triggers, the hash parameters are automatically cleared from the URL. This enables re-triggering the same view by changing the hash again.

Mixed Format Support: NEW Parameters can be combined within the hash fragment using the same query string syntax:

When to Use Hash Fragments vs Query Parameters

Available Triggers

Use Cases with Examples

Legacy Aliases

Hash Fragment Support `NEW`

Dynamic Re-triggering: `NEW` Hash-based triggers support dynamic re-triggering without page reload through the `hashchange` event. This is particularly useful for single-page applications (SPAs) where you want to trigger modals multiple times without full page refreshes.

Automatic Hash Cleanup: `NEW` After processing hash-based triggers, the hash parameters are automatically cleared from the URL. This enables re-triggering the same view by changing the hash again.

Mixed Format Support: `NEW` Parameters can be combined within the hash fragment using the same query string syntax: