Joy AI Agent

Joy AI is a built-in assistant that helps you set up programs, plan strategy, debug issues, and navigate the app — all from a chat interface

circle-info

Joy AI is currently in Beta. Responses may occasionally be incomplete or inaccurate. Always verify important changes before saving.

Overview

Joy AI is a conversational assistant built into the Joy app. You can ask it questions about the app, ask it to prepare forms for you, run a strategy planning session, or debug why something isn't working — without leaving the page.

It does not make changes automatically. When Joy AI wants to configure something, it prepares the form and shows you a preview card. You review it and click Apply to open the pre-filled form, then save it yourself.

How to open Joy AI

Click the magic wand icon (✦) in the bottom-left corner of the Joy app. The AI panel slides open on the right side of the screen.

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.

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 left sidebar lists your conversation threads. You can create a new conversation, rename, or delete existing ones.

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 / command — type / to browse built-in commands (see below).

  • Attach an image — click the image icon or paste from clipboard. Useful for sharing a screenshot when describing an issue.

Built-in / commands

Type / in the message box to see a list of ready-made prompts. Select one to send it as your message:

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.)

Skills

Skills are specialist modules the AI loads on demand. Click the + icon in the composer and select Skills, or the AI will load them automatically when relevant.

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

Onboarding Guide

Setup order, quick wins, store-type recommendations

Industry Templates

Industry-specific configs for fashion, beauty, F&B, pets, etc.

Plan Advisor

Reviews your current Joy plan and whether you should upgrade

Order Points Debugger

Diagnoses why an order didn't earn points (11-point checklist)

Discount Code Troubleshooter

Diagnoses why a discount code isn't working

Referral Program Optimizer

Referral reward structure, anti-fraud, conversion optimization

Campaign Advisor

Bonus point events, BFCM, seasonal campaigns, re-engagement

Notification Customizer

Email templates, notification variables, content customization

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 (e.g. "Set up Earning Program") — 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.

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.

Use the copy icon in the Canvas header to copy the full document to your clipboard.

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. These are stored in the Memory tab.

You can view, edit, or delete individual memory items directly from the tab.

FAQs

Will Joy AI make changes to my store automatically?

No. Every change goes through a form prefill card — the AI prepares the form, shows you a preview, and you click Apply to open the form. You review it and save it yourself. Nothing changes without your explicit action.

Is Joy AI available on all plans?

Joy AI is currently available in Beta. Check the in-app panel for current plan availability.

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 image icon in the composer. This is useful for showing the AI a screenshot of something that isn't working.

How do I start fresh with a new conversation?

Click New conversation at the top of the left sidebar. Your previous conversations are saved and you can switch back to them any time.

Last updated

Was this helpful?