Joy AI Agent
Joy AI is a built-in assistant that sets up programs, plans strategy, debugs issues, reads your reports, and navigates the app — all from a chat interface
Joy AI is in Beta and available on Essential plans and above. Responses may occasionally be incomplete — always verify before saving.
Overview
Joy AI is a conversational assistant built into the Joy app. You can ask it about your customers, programs and reports, have it prepare forms, run a strategy planning session and apply the plan, adjust a customer's points, or debug why something isn't working — without leaving the page.
Joy AI changes your store in three ways, and you stay in control of each one:
- It prepares a form, and you save it. For most changes, Joy AI shows a preview card. You click the button on the card, such as Apply to Form, to open the pre-filled form, then save it yourself.
- It acts after you confirm. Adjusting a customer's points shows a card with Confirm, and applying a loyalty plan shows an Apply loyalty plan? card with Apply. The action runs only once you click it.
- It acts when you ask, for a sync. Re-syncing a customer's loyalty data to Shopify runs as soon as you ask. It copies data Joy already holds and changes no balance.
Everything else Joy AI does is read-only.
How to open Joy AI
Click the magic wand icon (✦) in the bottom-left corner of the Joy app. The AI panel opens on the left side of the screen. You can move and resize it.
The first time you open it, you'll see a beta consent modal explaining what the assistant can do and its limitations. Click I understand, let me try to proceed.
What Joy AI can do
| Area | What Joy AI does |
|---|---|
| Customers and orders | Finds a customer and shows their points, VIP tier and activity. Explains why an order did or did not earn points. Counts customers |
| Your setup | Reads your programs, shop settings, setup checklist, theme status and test mode. Checks how a discount code was used. Reviews your cashback rate against your average order value |
| Reports | Reads your dashboard overview, points generated, redemption rate, top earners, referrals and Analytics V2 reports. Runs program health checks, a point economy calculator, and a loyalty page and storefront audit |
| Programs | Prepares earning, redeeming, referral and VIP tier forms, and updates an existing program instead of creating a duplicate |
| Planning | Runs a strategy session in Canvas with a task list, then applies the plan when you confirm |
| Widget editor | Proposes design changes from a description or from your storefront URL, and suggests translation edits. You apply and save them |
| Guidance | Answers how-to questions from the help center, suggests a plan, suggests a point label, and connects you to support |
The interface
The AI panel has four tabs at the top:
| Tab | What it shows |
|---|---|
| Chat | The main conversation — your messages and AI responses |
| Canvas | A persistent document the AI writes for planning sessions (appears automatically when the AI creates one) |
| Todos | A task progress list showing what the AI is working through (appears automatically during multi-step tasks) |
| Memory | Things the AI has remembered about your store and preferences |

The conversation picker at the top left of the panel lists your conversation threads. Open it to start a new conversation, or to rename or delete an existing one.

Next to the message box, Chat and Plan switch the mode. Chat is the default. In Plan mode, Joy AI researches your store and writes a strategy to Canvas and a checklist to Todos, without changing anything. Switch back to Chat to carry the plan out.
Starting a conversation
Type your message in the input box at the bottom of the Chat tab. You can also:
- @mention a resource — type
@to reference a specific product, customer, order, or collection. The AI will have that item in context. - Use a skill or a command — type
/to pick a skill, or use the + icon to open the commands (see below). - Attach an image — click the + icon and choose Image, or paste from the clipboard. Useful for sharing a screenshot when describing an issue.
- Share a link — paste a storefront URL and Joy AI takes a screenshot and audits the page.
Built-in / commands
Commands are ready-made prompts. Click the + icon in the message box, choose Skills & Commands, and scroll to Commands. Select one to put its prompt in the message box, change it if you like, then send it. To save a prompt of your own, click Create custom command at the bottom of the list. Your commands appear under My Commands.

| Command | What it does |
|---|---|
/plan-loyalty-program | Designs or redesigns your full loyalty program strategy, writes the plan to Canvas |
/audit-loyalty | Audits your earning rules, redemption, tiers, touchpoints, and integrations — creates a todo list of improvements |
/create-vip-tiers | Designs a VIP tier structure with names, thresholds, and benefits |
/setup-referrals | Plans and configures your referral program |
/analyze-customers | Segments your customers and shows engagement metrics |
/check-revenue | Reviews loyalty program revenue impact and key metrics |
/optimize-points | Reviews your earning/redemption rates and recommends adjustments |
/write-email | Drafts loyalty email content (welcome, points reminder, re-engagement, etc.) |
/setup-points-program | Walks you through the points earning setup step by step and tracks each step in a todo list |
/launch-checklist | Builds a pre-launch checklist covering configuration, testing, emails, widget and marketing |
/audit-retention | Runs a retention audit: repeat purchase rate, purchase frequency, CLV, churn and AOV against benchmarks |
/store-analytics | Reviews store performance: revenue trends, AOV, returning customer rate and top products |
/loyalty-impact | Compares your Shopify store data with your Joy data to show what the program changes and where to improve |
/init | Guided onboarding: learns your store, plans a program for your industry and sets it up step by step |
Skills
Skills are specialist modules the AI loads on demand. Type / in the message box and pick one from the list, or click the + icon and choose Skills & Commands. Joy AI also loads a skill by itself when your question needs one.

You can pick these skills from the list:
| Skill | What it focuses on |
|---|---|
| Loyalty Strategist | Point economics, tier design, reward psychology, program ROI |
| Retention Expert | Audits CRR, Repeat Purchase Rate, CLV, Churn Rate, AOV, Purchase Frequency |
| Revenue Optimizer | AOV optimization, cashback rates, redemption strategy |
| Campaign Advisor | Bonus point events, BFCM, seasonal campaigns, re-engagement |
| Industry Templates | Industry-specific configs for fashion, beauty, F&B, pets, etc. |
| Referral Program Optimizer | Referral reward structure, sharing channels, anti-cheat, limits, conversion |
| Onboarding Guide | Setup order, quick wins, store-type recommendations |
| Storefront Auditor | Checks that your Joy touchpoints are visible, on-brand and working on the live storefront |
| Plan Advisor | Reviews your current Joy plan, feature limits by plan and whether you should upgrade |
| Notification Customizer | Email templates, notification variables, content customization |
| Email Copywriter | Loyalty email copy, subject lines and campaign content |
| Analytics Interpreter | Reads ShopifyQL results, benchmarks store metrics and spots trends |
| Loyalty Analytics Advisor | Cross-references your Shopify store data with Joy loyalty metrics |
| Integration Advisor | Recommends and plans Joy integrations for your tech stack |
| Shopify Flow Advisor | Joy + Shopify Flow triggers, actions, templates and troubleshooting |
| Migration Advisor | Moving from another loyalty app to Joy |
| Order Points Debugger | Diagnoses why an order did or did not earn points, across 20+ conditions and edge cases |
| Discount Code Troubleshooter | Diagnoses why a discount code isn't working |
Joy AI also loads these five skills by itself. They are not in the list:
| Skill | What it focuses on |
|---|---|
| AI Onboarding Wizard | Discovers your store, plans a program for your industry and sets it up step by step |
| Rule Engine Guide | Multiple earning programs with conditions, priorities and stacking |
| Customer Audit | Audits one customer using their Joy loyalty data and Shopify sales |
| Troubleshooter | Diagnoses common program, widget and configuration issues |
| Agent Capabilities | Explains what Joy AI can and cannot do |
Form prefill
When you ask the AI to create or configure something, it prepares the form and shows you a preview card in the chat. The card lists the key fields and values it will set.
Click the button on the card, such as Apply to Form — Joy navigates you to the correct settings page with all fields already filled in. Review every field, make any adjustments, then click Save.
Nothing is saved until you save the form yourself.

Actions that run after you confirm
Two actions don't use a prefill form. Joy AI shows a confirmation card and runs the action itself once you approve it: Confirm for a points adjustment, Apply for a plan. Click Cancel to discard the card.
Adjust a customer's points
Ask "Add 100 points to [email protected], reason: compensation." Joy AI finds the customer and shows a card with the customer, the points change, the new balance, and your reason. Review it, then click Confirm to apply it.

When you confirm:
- The customer's balance updates immediately, recorded in their activity log as an admin adjustment.
- Joy AI does not email the customer about the change.
- The action runs only once — confirming twice, or from another tab, won't double-apply it.
If you send another message before you click Confirm, the card is cancelled and no points change.
Apply a loyalty plan
When you plan a program, Joy AI writes the plan to Canvas. When the plan is ready, tell Joy AI to apply it, for example "apply the plan". In the setup wizard, the apply button does the same. Joy AI shows an Apply loyalty plan? card with a summary, such as the number of earning programs, rewards and VIP tiers it will apply. Click Apply to run it:
- Shop settings in the plan, such as your point label, widget color and discount prefix.
- Earning and redeeming programs. Programs that already exist are skipped, so applying again does not create duplicates.
- Referral settings.
- VIP tiers.
Applying a plan that includes VIP tiers replaces your existing VIP tiers. Joy removes the current tiers and creates the new ones, so tier rewards on the old tiers are cleared. Review the card before you click Apply.
Customer data sync
When you ask Joy AI to sync a customer, it updates that customer's Shopify metafields and tags from their Joy data — points, VIP tier and tags. Use it after a tier or points change that has not reached Shopify yet. This runs as soon as you ask, without a confirmation card, and it does not change the customer's balance.
Canvas
When you run a planning session (e.g. /plan-loyalty-program), the AI writes a structured document in the Canvas tab. The tab switches automatically when Canvas content is created.
Canvas contains markdown content — headings, tables, lists — that you can read and use as a reference while configuring your program. The AI also uses it to show strategy documents, point economics tables, VIP tier comparisons, or campaign plans. When a plan is complete, ask Joy AI to apply it, as described above.
Open the ... menu in the Canvas header to edit or rename the document, copy it to your clipboard, or export it as Markdown.

Task progress (Todos)
For multi-step tasks, the AI shows a Todos panel listing each step with its status: pending, in progress, or completed. A progress bar shows overall completion.
The panel auto-switches to this tab when a task starts, and collapses to show just the active step when minimized. When all steps complete, it shows a "Complete" state.
Memory
Joy AI can remember things about your store across conversations — your program goals, preferences, things you've told it, or decisions you've made. Say "remember that..." to save one. These are stored in the Memory tab.
You can view, edit, or delete individual memory items directly from the tab, and add a note of your own in the Add a memory box at the bottom.
Frequently asked questions
Will Joy AI make changes to my store automatically?
Not without your action. Most changes go through a form prefill card that you open and save yourself. Adjusting a customer's points and applying a plan use a confirmation card and run only after you click Confirm or Apply. The one action that runs on your request alone is a customer data sync, which copies data Joy already holds to Shopify.
Can Joy AI edit my loyalty widget or loyalty page?
In the widget editor, Joy AI proposes design changes and translation edits, and you apply and save them. Joy AI does not publish storefront changes on its own.
What does "Your Loyalty Hub was just changed by Joy AI" mean?
An AI assistant connected to your store changed your Loyalty Hub design while the editor was open. Reload the editor to see the latest version before you save, so you do not overwrite the change.
Is Joy AI available on all plans?
Joy AI is currently in Beta and available on Essential plans and above.
The AI gave me wrong information — what should I do?
Joy AI is in beta and may occasionally be inaccurate. If something doesn't look right, verify it against the help docs or contact the support team. You can also tell the AI it was wrong — it will try to correct itself.
Can I attach screenshots or images to my message?
Yes — paste an image from your clipboard, or click the + icon in the message box and choose Image. This is useful for showing the AI a screenshot of something that isn't working.
How do I start fresh with a new conversation?
Open the conversation picker at the top left of the panel and click New conversation. Your previous conversations are saved and you can switch back to them any time.
Need help?
Reach out at [email protected] with your store URL and "Joy AI" in the subject — we will look at the conversation with you.