Getting Started: Complete Setup Guide
A comprehensive walkthrough of every decision and step to launch your Angle membership program — from app installation to activation.
This guide walks you through every decision and configuration step to launch a fully operational Angle membership program. Follow it from top to bottom and you'll go from a fresh install to a live program with tiers, cashback, wallet passes, onsite extensions, and Klaviyo marketing automation.
Before You Begin: Prerequisites
Before installing Angle, make sure your Shopify store meets these requirements. The app will not function correctly without them.
Required
| Requirement | Where to Check | Why It's Needed |
|---|---|---|
| Customer Accounts enabled | Shopify Admin → Settings → Customer accounts | Angle requires Shopify's new Customer Accounts (not Legacy). Store credit balances, tier status, and account extensions all depend on this. |
| Store Credit enabled | Shopify Admin → Settings → Payments → Store credit | This is the core infrastructure. Angle writes to Shopify's native store credit ledger — not a separate points database. If store credit isn't enabled, rewards can't be issued. |
| Shopify Plus (recommended) | Your Shopify plan | Required for the Checkout Extension and full checkout extensibility. Non-Plus stores can still use the Customer Account Extension but won't get the checkout integration. |
Recommended
| Requirement | Why |
|---|---|
| Online Store 2.0 theme | Required for the Customer Account Extension app block |
| Active Klaviyo account | Powers all marketing automation — enrollment emails, credit reminders, tier change notifications, expiration alerts |
| Shopify POS | Needed for in-store wallet pass scanning and omnichannel identification |
Step 1: Install the Angle App
- Log in to your Shopify Admin Dashboard
- Navigate to Apps → Add apps
- Search for "Angle Store Credit Memberships" in the Shopify App Store
- Click Install app
- Review the permissions Shopify displays — Angle requires access to customers, products, orders, discounts, store credit, and Online Store data
- Click Install to authorize
Once installed, the app appears in your Shopify admin sidebar under Apps. Open it and you'll see the Angle navigation sidebar with: Retention Dashboard, Membership, Onsite, Integrations, and Contact Us.
Step 2: Plan Your Program (Key Decisions)
Before touching any settings, you need to make four foundational decisions. These shape everything else and some cannot be changed after activation without disabling the program.
Decision 1: What is your program called?
This is the customer-facing name that appears on wallet passes, account pages, checkout, and emails. Pick something that reflects your brand identity — not generic loyalty language.
Examples from real Angle brands:
- "The Oak Society" (Silver Oak)
- "Pack Perks™" (Ruffwear)
- "The Cellar Society" (wine brand pattern)
Decision 2: How do customers qualify — spend or tags?
This is your enrollment qualifier and it applies globally to the entire membership. You cannot mix models across tiers.
| Model | How It Works | Best For |
|---|---|---|
| Spend-based | Customers are automatically placed into tiers based on cumulative qualifying spend. No manual intervention needed. | Most brands. Straightforward, self-service, scales automatically. |
| Tag-based | Customers are enrolled when specific Shopify customer tags are added to their profile — either manually or via Shopify Flow. | Employee programs, invite-only programs, subscription-gated tiers, or any scenario where enrollment should be controlled. |
Common pattern: Many brands run two separate membership programs — a spend-based program for customers and a tag-based program for employees (e.g., Jones Road runs an employee allowance program alongside their customer program).
Decision 3: How long do customers keep their tier?
This is the tier eligibility period and only applies to spend-based programs.
| Period | How It Works | Best For |
|---|---|---|
| Calendar year | Qualify in any month → keep the tier through the end of the next calendar year. Example: qualify Nov 2025 → tier retained until Dec 31, 2026. | Brands that want annual re-qualification aligned to the fiscal year. Creates urgency at year-end. |
| Rolling year | Tier lasts exactly 12 months from the date of qualification. Each customer's window is independent. | Brands that want a consistent 12-month benefit window regardless of when the customer qualified. |
| Lifetime | Once qualified, customers keep their tier permanently. | Premium or aspirational programs where reaching a tier is a milestone, not a subscription. |
Decision 4: How many tiers, and what are the thresholds?
You can create up to 5 tiers per membership. Each tier needs a name, a spend threshold (for spend-based programs), and its own set of rewards and wallet pass design.
Common patterns:
| Vertical | Tier Structure |
|---|---|
| Wine | 3 tiers: $600 / $1,200 / $6,000 — with experiential benefits scaling at each level |
| Outdoor/Lifestyle | 2–3 tiers: $0 (everyone) / $250 / $500 — with graduated cashback rates (5% / 7% / 10%) |
| Beauty/Cosmetics | 2 tiers: $0 (all customers) / $200 (VIP) — plus a separate tag-based employee program |
Step 3: Create Your Membership Program
-
Open the Angle app → Membership in the sidebar
-
Click Create membership program
-
Configure:
- Membership name — Enter your program name
- Membership eligibility — Select "All customers" (most common) or opted-in only
- Enrollment qualifier — Choose "Spend-based" or "Tag-based"
- Tier eligibility period (spend-based only) — Select Calendar year, Rolling year, or Lifetime
- Exclude customers — Add tags for any customers who should be excluded (e.g., "Employee", "wholesale"). Choose whether to exclude customers matching "any" or "all" specified tags
- Notifications — Toggle "Send store credit emails" on if you want Shopify to automatically email customers when credit is added to their account. Click "Preview email" to see the template
-
Click Save
Do NOT activate the program yet. You need to create tiers, configure rewards, set up wallet passes, and install extensions first. The activation step comes at the end.
Step 4: Create and Configure Your Tiers
For each tier in your program:
- On the Membership page, click Create new tier
- Enter the Tier name (e.g., "Silver", "Gold", "The Cellar")
- For spend-based programs, enter the Amount spent threshold — the minimum cumulative spend required to qualify
- A Tier tag is auto-generated in the format
MembershipName:TierName— this tag is applied to qualifying customers automatically and cannot be changed after saving - Click Save
Repeat for each tier. Tiers are listed on the Membership page and can be reordered, edited, or deleted.
Step 5: Configure Rewards for Each Tier
Open each tier and scroll to the Rewards section. All reward types are disabled by default — enable only the ones you want to offer.
Order-Based Cashback
Enable this to give members store credit as a percentage of each purchase or a flat amount per order.
Configuration decisions:
| Setting | What to Decide | Guidance |
|---|---|---|
| Reward value | Percentage of order value or flat dollar amount | Most brands use percentage-based (e.g., 5%, 7%, 10%). The percentage is calculated on order value excluding any store credit already applied — this prevents circular reward compounding. |
| Reward expiration | How many days until the credit expires | Common range: 90–365 days. Shorter expiration drives urgency; longer expiration feels more generous. Set to 0 for no expiration. |
| Reward delay | How long to wait before issuing credit | Strongly recommended: set a delay (e.g., 14–30 days). During the delay, Angle recomputes the reward against any returns, cancellations, or order modifications — so you never over-issue credit. Customers see a "Pending Balance" so they know it's coming. |
Referrals
Enable this to reward members when they refer new customers.
Configuration decisions:
| Setting | What to Decide |
|---|---|
| Member receives | Dollar amount the referring member gets (e.g., $10) |
| Referee receives | Dollar amount the new customer gets (e.g., $10) |
| Reward expiration | How long the referral credit stays valid |
Referral rewards are only issued after the referred customer completes their first purchase — not on sign-up alone.
Tip: Scale referral values by tier to incentivize your most passionate customers to refer more aggressively (e.g., Entry: Give $10/Get $10, Top Tier: Give $50/Get $25).
Custom Action Rewards (via Shopify Flow)
Beyond cashback and referrals, you can issue store credit for virtually any customer action using Shopify Flow. This is configured outside of the tier settings — see Step 9 below.
Step 6: Design Your Wallet Passes
For each tier, configure the Apple and Google Wallet pass that customers will install on their phones.
- On the tier's edit page, find the Apple & Google Wallet Pass section
- Click Edit to open the wallet pass editor
Design Settings
| Setting | What It Does |
|---|---|
| Background color | The pass background (hex color picker) |
| Text color | Text color for all pass labels (hex color picker) |
| Icon | Small icon shown in the wallet app (top-left of pass) |
| Logo | Larger brand logo displayed on the pass body |
Display Options
| Setting | What It Does |
|---|---|
| QR code alt text | Text shown below the QR code — typically the referral offer (e.g., "Give $5 ❤ Get $5") |
| Always show QR code | Enable this if you want POS scanning even without referrals enabled. Critical for in-store identification. |
| Hide pass balance | Enable for programs that don't issue store credit (e.g., pure tier-based or employee programs) |
Add Shortcuts
Shortcuts are quick-access links on the back of the wallet pass. Click Add to create shortcuts linking to your website, product collections, exclusive offers, or support pages. Each shortcut has a title, link label (max 20 characters), and HTTPS URL.
Preview
Use the iOS/Android toggle in the editor to preview how the pass looks on each platform before saving.
Step 7: Set Up Onsite Extensions
Navigate to Onsite in the Angle sidebar. You'll see two extension cards.
Customer Account Extension (All Shopify Plans)
This embeds a membership card on the customer's account page showing their tier, balance, pending balance, and a QR code to download their wallet pass.
Setup:
- Go to Online Store → Themes in Shopify Admin
- Click Customize on your active theme
- Use the page dropdown to select a Customer Account Page (e.g., Profile)
- In the left sidebar, click Add block
- Search for "Angle Customer Account Extension"
- Drag to position it where you want it on the page
- Click Save
Checkout Extension (Shopify Plus Only)
This surfaces store credit at checkout — showing available balance, how much credit will be earned, and a toggle to apply credit to the current order.
Setup:
- In the Angle app, go to Onsite
- Click Customize under Checkout Extension
- You'll be redirected to Shopify's Checkout Editor
- Click Add App Block and search for Angle Store Credit Memberships
- Drag the block to the desired location (e.g., Payment or Order Summary section)
- Click Save
Test both extensions with an enrolled customer who has available credit before going live. This lets you verify the full experience — balance display, credit application, and wallet pass download.
Step 8: Connect Klaviyo
Klaviyo powers all of Angle's marketing automation. Without it, you won't have enrollment emails, tier change notifications, credit earned alerts, or expiration reminders.
- In the Angle app, go to Integrations
- Click Connect Klaviyo and authenticate your Klaviyo account
- Once connected, 8 event triggers become active automatically
Angle → Klaviyo Events
| Event | When It Fires |
|---|---|
| Angle Customer First-Time Enrolled | Customer joins the membership program for the first time |
| Angle Customer Tier Enrolled | Customer re-joins a tier |
| Angle Customer Tier Changed | Customer moves to a different tier |
| Angle Customer Tier Unenrolled | Customer drops out of their tier |
| Store Credit Earned | Customer earns store credit from any action |
| Store Credit Expiring 30 days | Credit is set to expire in 30 days |
| Store Credit Expiring 7 days | Credit is set to expire in 7 days |
| Store Credit Expiring 24 hours | Credit is set to expire in 24 hours |
What to Build in Klaviyo
At a minimum, create email flows for these events:
- Welcome flow — Triggered by "First-Time Enrolled." Introduce the program, explain how to earn and redeem credit, and include a link to download the wallet pass.
- Credit earned notification — Triggered by "Store Credit Earned." Let customers know they've earned credit and encourage them to shop.
- Tier upgrade celebration — Triggered by "Tier Changed." Congratulate the customer and explain their new benefits.
- Expiration reminders — Triggered by the three expiration events. Create urgency to redeem before credit expires.
Angle pushes rich profile properties to Klaviyo (tier name, credit balance, spend toward next tier, referral count, wallet pass link) so you can personalize every email.
Step 9: Set Up Shopify Flow Automations (Optional but Powerful)
Shopify Flow lets you issue store credit for any customer action beyond standard cashback — product reviews, birthdays, subscription milestones, employee allowances, and more.
How to Create a Custom Action Reward Flow
- Open Shopify Admin → Apps → Shopify Flow
- Create a new workflow
- Add any trigger (e.g., "Customer joined segment," "Order created," a scheduled date trigger)
- Add the action: Angle: Custom Action Rewards (under "Angle Store Credit Memberships action")
- Configure:
- Customer — Set to
customer.id - Value — The reward amount (should not exceed $1,000)
- Currency — Leave empty to use your store's default, or enter a specific currency code
- Expiration days — Days until the reward expires (0 = no expiration)
- Notify customer — Check to send a store credit notification email
- Customer — Set to
- Save and activate the workflow
Popular Flow Recipes
| Use Case | Trigger | Reward |
|---|---|---|
| Review reward | Customer submits a product review (via Junip, Okendo, etc.) | $5 credit |
| Birthday reward | Customer birthday metafield matches today's date | $20 credit |
| First purchase anniversary | 365 days after first order | $15 credit |
| Wallet pass download incentive | Customer downloads wallet pass | $5 credit |
| Subscription milestone | Customer reaches X months of subscription | Bonus credit |
| Employee allowance | Customer joins "Employee" segment | Recurring $200 credit every 60 days |
Step 10: Activate Your Program
Once everything is configured and tested:
- Go to Membership in the Angle app
- You'll see a yellow warning banner: "This membership must be activated for your customers to use it"
- Click Activate
- Read the confirmation modal carefully — it explains that customers will be placed into tiers and will start earning credit immediately
- Confirm activation
Important: After activation, you must disable the program to make any changes to tiers, rewards, eligibility, or program settings. The workflow is: Disable → Edit → Re-activate. Plan your configuration carefully before activating.
Step 11: Post-Launch Checklist
After activation, verify everything is working:
| Check | How to Verify |
|---|---|
| Tier assignment | Open a qualifying customer's profile in Shopify Admin and confirm the tier tag was applied (format: MembershipName:TierName) |
| Store credit issuance | Place a test order with a qualifying customer and verify pending credit appears (if using reward delay) or credit is issued immediately |
| Wallet pass | Download the wallet pass on both iOS and Android and confirm branding, balance display, and QR code work correctly |
| Customer Account Extension | Log in as a test customer and verify the membership block appears on the account page |
| Checkout Extension | Add items to cart as a test customer with credit and verify the credit display and apply toggle work at checkout |
| Klaviyo events | Check your Klaviyo account for incoming Angle events and verify your flows are triggering correctly |
| POS scanning (if applicable) | Scan a wallet pass QR code at a POS terminal and verify the customer profile loads |
Ongoing Operations
- Monitor the Retention Dashboard in the Angle app for enrollment trends, credit issuance, and redemption rates
- Review Klaviyo flows regularly to optimize email engagement
- Check for pending credit that may need attention (returns during delay periods)
- Use receipt capture if you sell through off-platform channels (restaurants, wholesale partners) — customers can text photos of receipts to a dedicated SMS number, and staff can allocate qualifying spend via the "Add receipt" function on the customer profile
Quick Reference: Program Architecture
| Component | What It Does |
|---|---|
| Store Credit Engine | Determines when credit is issued, how much, to whom, and when it expires |
| Membership System | Tier-based segmentation with distinct benefits per tier |
| Wallet Pass Platform | Apple and Google Wallet passes for identification, push notifications, and referral sharing |
| Omnichannel Identity | Ties online and offline activity together via wallet pass QR scanning and receipt capture |
| Klaviyo Integration | Marketing automation with 8 event triggers and rich profile properties |
| Shopify Flow Integration | Custom reward automation for any trigger you can imagine |
| Onsite Extensions | Customer Account and Checkout blocks that surface loyalty data in the shopping experience |
| Analytics Engine | Retention dashboard, causal inference modeling, and health scorecards |
Need Help?
Use the Contact Us link inside the Angle app, or email support@anglehq.com directly. The support form is in the app sidebar under Contact Us.