URL Triggers
Open modals and trigger actions using URL query parameters
Overview
URL triggers allow you to open specific modals and initiate user flows by adding query parameters to any page URL. This enables deep linking to authentication flows, subscription purchases, and account management screens.
Example: To open the login modal, append ?view=login to any page URL:
https://yoursite.com/?view=login
Available Triggers
| Trigger | Description | Parameters |
|---|---|---|
?view=login | Opens the login modal | - |
?view=register | Opens the registration modal | plan_id |
?view=plan-select | Opens subscription plan selection | product_id, plan_id, is_gift |
?view=password-forgot | Opens the forgot password modal | - |
?view=password-reset | Opens the password reset modal | - |
?view=password-change | Opens the password change modal (requires authentication) | - |
?view=passwordless-request | Opens passwordless login request | - |
?view=passwordless-login | Completes passwordless authentication | token (required) |
?view=email-verify | Verifies email address | token (required) |
?view=user-edit | Opens user profile editor | - |
?view=address-create | Opens address creation modal | - |
?view=payment-method-update | Opens payment method editor | source_id (int), list |
?view=newsletter | Opens newsletter subscription modal | - |
?view=newsletter-update | Opens newsletter preferences editor | email |
?view=gift-redeem | Opens gift redemption modal | gift_code |
?view=invoice-details | Opens invoice details | id (required) |
?view=manage-members | Opens subscription member management | subscription_id (required) |
?view=cart | Opens shopping cart | sku_id |
?view=order-create | Starts e-commerce checkout | sku_id |
Use Cases
Direct subscription from marketing campaigns
Link users directly to a specific subscription plan from email campaigns, ads, or landing pages. Skip the plan selection step when promoting a specific offer.
https://yoursite.com/?view=plan-select&product_id=123&plan_id=456
Gift subscription promotion
Run a holiday or special occasion campaign where users can purchase subscriptions as gifts for others.
https://yoursite.com/?view=plan-select&product_id=123&plan_id=456&is_gift=true
Gift code redemption links
Include redemption links in gift notification emails so recipients can activate their gift with one click.
https://yoursite.com/?view=gift-redeem&gift_code=HOLIDAY2024
Email verification from transactional emails
Embed verification links in welcome emails to complete the email verification flow automatically.
https://yoursite.com/?view=email-verify&token=abc123xyz
Passwordless login from magic link emails
Send secure login links that authenticate users without requiring a password.
https://yoursite.com/?view=passwordless-login&token=xyz789abc
Pre-filled shopping cart from promotions
Create "Buy Now" links in promotional emails or banners that open the cart with specific products already added.
https://yoursite.com/?view=cart&sku_id=32,33,34
One-click checkout for single products
Link directly to checkout for a specific e-commerce item, reducing friction for impulse purchases.
https://yoursite.com/?view=order-create&sku_id=33
Invoice links in billing emails
Include direct links to invoice details in payment confirmation or billing reminder emails.
https://yoursite.com/?view=invoice-details&id=999
Team management from admin notifications
Send subscription admins directly to member management when seats are available or action is needed.
https://yoursite.com/?view=manage-members&subscription_id=555
Update payment method from failed payment emails
Direct users to update their payment information when a charge fails, with the specific payment method pre-selected.
https://yoursite.com/?view=payment-method-update&source_id=123
Newsletter preference center links
Include links in email footers that open the newsletter preferences modal for the recipient.
https://yoursite.com/?view=newsletter-update&[email protected]
Login prompts on gated content
Redirect users to login when they attempt to access subscriber-only content.
https://yoursite.com/?view=login
Registration links in marketing materials
Drive new user signups from external campaigns, QR codes, or partner sites.
https://yoursite.com/?view=register
Password reset from support interactions
Provide direct password reset links when assisting users via customer support.
https://yoursite.com/?view=password-forgot
Campaign attribution tracking
Append campaign keys to any trigger URL to track conversion sources in your analytics.
https://yoursite.com/?view=plan-select&product_id=123&plan_id=456&campaign_key=SUMMERPROMO
Legacy Aliases
For backward compatibility, these aliases are automatically converted:
| Legacy | Converted To |
|---|---|
?view=select | ?view=plan-select |
?view=redeem | ?view=gift-redeem |
?view=address | ?view=address-create |
Updated 1 day ago
