Custom program

This feature is available for Advanced and above plans

The Custom Program allows you to create flexible earning programs with triggers beyond the default options.
You can reward customers for any activity you define — whether it happens on your storefront, through a custom event, or inside Shopify Flow.

Each trigger action gives you more freedom to build unique, personalized experiences and automate loyalty rewards based on your own business logic.

A Custom program has four trigger actions: Visit a page, Custom trigger, Shopify Flow trigger and Mobile app action.

Trigger action options of a Custom program


1. Visit a page

🧩 Overview

This trigger allows you to reward customers when they visit a specific page on your storefront.
You can use it to create engaging earning activities, such as visiting your new collection, blog, or campaign landing page.
This is a great way to encourage traffic to important pages on your site.


⚙️ How to set up

1

Go to Reward programs → Add program → Custom program → Trigger action → Visit a page

2

Enter:

  • Program name
  • Page URL (exact page or contains specific keywords)
  • Choose reward and Rewarding value
  • Start / End date (optional)
3

Enable Fraud prevention if you want to limit repeated actions from the same customer.

4

Click Save to create the program.

5

Turn on the program when ready.


🧍 Customer experience

Once active, the program appears in your loyalty widget and loyalty page.
When a customer visits the configured URL, Joy automatically records the action and adds reward points.


FAQ: Visit a page

Q: Can I track visits for multiple pages?
A: Yes. You can create multiple custom programs, separate each program for each URL.

Q: Do I need to add any code?
A: No. Joy automatically tracks page visits once the program is active.


2. Custom trigger

🧩 Overview

The Custom trigger option lets you define your own event on your website — such as button clicks, form submissions, or any custom interaction — and reward customers when it happens.
This gives merchants maximum flexibility to connect Joy with any activity on their storefront or POS system.

Custom trigger option selected in the Trigger action list of a Custom program

Custom program with the Custom trigger selected: integration code and setup steps


⚙️ How to set up

1

Go to Reward programs → Add program → Custom program → Trigger action → Custom trigger

2

Create a new program by entering:

  • Program name
  • Choose reward and Rewarding value
  • Start / End date (optional)
  • Show on — choose where the program is available:
    • Online store only (default)
    • Online store & Point of Sale — also shows the program inside the Joy POS app so staff can reward customers in-store
  • Click Save
    → Joy automatically generates an action_key.
3

In the integration guide shown in-app:

  • Step 1: Copy the JS snippet provided.

  • Step 2: Add the code generated to your website where you want to trigger the reward action. This is normally placed inside event handlers (button clicks, form submissions, etc.)

    Example usage:

    • After a survey form is submitted

    • When a video finishes playing

    • When a specific button is clicked

    • After completing a quiz

  • Step 3: Activate the program

    Test your custom trigger yourself to update the connection status. Once successfully connected, you can turn on the program. You can also skip this step by selecting 'Skip' (status will become connected).

You can skip the connection test and turn it on directly — just make sure the integration code is correctly placed as intend.

Show on Point of Sale is available on plans that include POS. If your current plan doesn't support it, Joy will prompt you to upgrade when you pick Online store & Point of Sale.


🧍 Customer experience

Once the program is active:

  • Online store — when the custom trigger fires (for example, a button click or form submit), Joy receives the event and rewards the customer automatically.
  • Point of Sale — staff can manually reward customers in-store. See the next section for the cashier flow.

🛒 Running custom trigger programs on POS

When Show on is set to Online store & Point of Sale, custom trigger programs appear inside the Joy POS app so cashiers can reward customers for any in-store action you define — completing a tasting, attending a workshop, sharing on social media at checkout, etc.

Where it appears

  • Joy: Loyalty Programs POS tile → Custom programs tab
  • Customer details screen → Joy customer block (also lists eligible custom programs for the selected customer)

Cashier flow

1

Attach the customer to the cart (or open the customer record).

2

Open Joy POS → switch to the Custom programs tab.

3

Pick the program the customer has just completed in-store.

4

Tap Complete.

5

Joy rewards the customer with the configured points and shows a check mark on the program so it's clear it has been completed.

Limits and safeguards

  • The program respects the same earning limit / fraud prevention rules you set in the admin. If the customer has already hit the limit, tapping Complete will show an error and no points are awarded.
  • Each tap counts as one earn event for the attached customer — make sure the right customer is selected before tapping.

FAQ: Custom trigger

Q: What if I skip the connection step?
A: That's fine — just ensure the trigger code is added correctly. Once the trigger runs, Joy will recognize it automatically.

Q: Is coding required?
A: A basic understanding of HTML/JS is recommended to install the trigger code properly. For POS-only use, no code is needed — staff award points by tapping Complete in the Joy POS app.

Q: Can the same custom program run on both online store and POS?
A: Yes. Set Show on to Online store & Point of Sale. Online customers earn automatically when the JS trigger fires; in-store customers earn when a cashier taps Complete in Joy POS. Earning limits apply across both channels.

Q: I don't see the Custom programs tab in Joy POS.
A: Check that (1) the program is turned on, (2) Show on is set to Online store & Point of Sale, and (3) a customer is attached to the cart. The tab only lists programs eligible for the selected customer.


3. Shopify Flow trigger

🧩 Overview

This trigger allows you to connect Joy Loyalty directly with Shopify Flow, so you can reward customers based on any Flow automation — for example, when a customer makes a purchase, submits a form, or meets certain conditions.

This makes your loyalty program more flexible and powerful, integrating seamlessly into your existing Shopify automation workflows.

Custom program with the Shopify flow trigger selected: setup guide, action key and customer email


⚙️ How to set up

1

Go to Reward programs → Add program → Custom program → Trigger action → Shopify Flow trigger

2

Create a new program:

  • Enter the program name, Choose reward and Rewarding value
  • The Action Key already shows on the form. The form notes that the key is temporary until saved.
  • Click Save
    → Joy sets the program as draft.
3

Open Shopify Flow and create a new flow with your desired use case

4

Add an action → Trigger custom activity in your use case flow

  • Fill in:
    • Action Key: copied from Joy
    • Customer Email: customer email variable from Flow trigger, you can add by click add variable and search for email
  • Save the flow
  • Run a test by trigger the flow and the Trigger custom activity action
5

Go back to Joy

  • Once Joy detects a call from Shopify Flow with that Action Key, the status changes to Connected. (Joy will automatically check for conection status)
6

Click Turn on to activate the program.


🧍 Customer experience

Once the program is turned on:
Whenever the connected Flow runs and the action is triggered, Joy will automatically reward customers with the points defined in your custom program.


FAQ: Shopify Flow trigger

Q: What if my Flow doesn’t show up in Joy?
A: Make sure the Flow has been triggered at least once and that the Action Key matches exactly.

Q: Is Shopify Flow required to use Joy?
A: No. Shopify Flow is optional — you can still use the “Visit a page” or “Custom trigger” options instead.


4. Mobile app action

The Mobile app action option rewards a customer once for an action in your Shopney app: their first login, or turning on notifications. It is available on the Ultimate plan.

Go to Reward programs → Add program → Custom program → Trigger action → Mobile app action. See the full guide: Mobile app action.


Need help?

Contact us via the live chat widget in your Joy admin, or email us at [email protected].