Customer Portal
The Gro customer portal gives your subscribers self-service access to manage their subscriptions without contacting support. It’s embedded directly in your Shopify storefront, so customers stay within your brand experience.
Key Features
Section titled “Key Features”- View subscriptions — customers see all their active, paused, and cancelled subscriptions
- Manage deliveries — view upcoming orders, skip deliveries, or reschedule
- Update box contents — change Build-a-Box selections for the next delivery
- Add extras — browse and add upsell products as one-time or recurring items
- Update payment — redirect to Shopify’s payment method update flow
- Cancel or pause — with optional retention offers
- Reactivate — restart cancelled subscriptions with optional winback offers
- Referrals — view and share referral codes
How It Works
Section titled “How It Works”The portal runs as a Shopify App Proxy, meaning it’s accessible at your-store.com/apps/gro/portal/. It inherits your store’s theme layout, so the portal feels like a native part of your storefront.
Authentication
Section titled “Authentication”Customers are authenticated automatically when they’re logged into your Shopify store. The portal also supports:
- Magic links — passwordless login links sent via email for customers who aren’t logged in
- Direct links — secure links you can include in emails to take customers straight to their subscription
Deep linking to a tab
Section titled “Deep linking to a tab”Add a tab query parameter to any portal subscription link (magic links and direct links included) to open the customer straight onto a specific tab. If the value is missing or unrecognised, the portal falls back to the Overview tab.
tab value | Opens |
|---|---|
overview (or details) | Overview |
delivery-details (or plan) | Delivery details |
payment-details (or payments) | Payment details |
orders | Orders |
refer-friends (or referrals) | Refer friends |
For example, to drop a customer straight onto their payment tab (handy in a dunning email asking them to update a failed card):
https://your-store.com/apps/gro/portal/app/subscription/{subscriptionId}?session_token={token}&tab=payment-detailsEnabling the Portal
Section titled “Enabling the Portal”The portal is enabled by default when you install Gro. Configuration options are available in Subscriptions → Settings → Customer Portal in the Gro dashboard, including:
- Retention offer cooldown period
- Which actions customers can perform (skip, reschedule, cancel, etc.)
- Magic link expiry settings