> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nudj.cx/llms.txt
> Use this file to discover all available pages before exploring further.

# Promotions and Multipliers

> Points multipliers, streak rewards, achievement templates, and leaderboards inside the Shopify embedded admin.

The Shopify embedded admin surfaces three loyalty mechanics merchants configure without engineering support: points multipliers, streak rewards, and pre-built achievement templates. Each ships as a first-class page with inline setup.

## Points multiplier promotions

PR #2010 added a **points multiplier promotions** page to the Shopify admin. Merchants can define time-windowed promotions — e.g. 2× points on Fridays, 3× points during Black Friday — and the multiplier applies to any points-earning action within the window.

Under the hood, multiplier promotions layer on top of the [effects system](https://github.com/nudj-digital/nudj/blob/main/packages/services/service/points-transaction/helpers/points-multiplier.ts) — user-scoped modifiers stored on `communityData.effects[]`. Multiple active multipliers don't stack; the highest wins per type.

<Frame caption="Reward type picker: XP Boost and Points Boost are the platform multipliers (temporary XP/points multipliers for a configurable duration).">
  <img src="https://g0cvqggimgcfezpr.public.blob.vercel-storage.com/pr-screenshots/NUDJ-0000-docs-audit-enterprise-1776495079502/reward-type-picker.png" alt="Create a New Reward modal showing XP Boost and Points Boost multiplier types" />
</Frame>

## Streak rewards

PR #2000 added **streak rewards** to the Shopify admin. Merchants define a streak-based reward — complete N consecutive days of action X, earn reward Y. PR #2005 wired the streak toggle (and achievement toggle) on/off from the settings page so merchants can enable the mechanic per community.

<Frame caption="Edit Streak Configuration panel — trigger events that extend a users streak, with live preview.">
  <img src="https://g0cvqggimgcfezpr.public.blob.vercel-storage.com/pr-screenshots/NUDJ-0000-docs-audit-enterprise-1776495079502/streak-rewards-config.png" alt="Streak configuration screen with trigger events and preview" />
</Frame>

## Achievement template library

PR #2133 shipped an **achievement template library** tailored for simplified D2C setup. Merchants pick from pre-built achievement definitions (first purchase, review submission, social follow, etc.) instead of authoring each from scratch. This is the fastest path from install to a populated programme.

## Game settings

PR #1986 added a **game settings modal** with a tabbed config UI. Games (birthday challenges, badge collections, etc.) share a configuration surface so merchants don't have to learn a new UI per game type.

## Leaderboard templates

PR #2220 added a **leaderboard template library** with an edit-in-admin deep-link — merchants can preview a template inside the Shopify admin, then jump straight into the full Nudj admin to tweak advanced settings.

## Putting it together

A typical mid-tier Shopify loyalty programme using these levers:

1. Apply a **holiday points multiplier** (PR #2010) for a sales event.
2. Enable a 7-day **streak reward** (PR #2000, #2005) to drive return visits.
3. Seed the programme with 3–5 **achievement templates** (PR #2133) from the library.
4. Surface the [Ways to Earn widget](/enterprise/shopify/storefront-widgets) on the storefront so shoppers see what they can earn.

## Next steps

<CardGroup cols={2}>
  <Card title="Rewards" icon="gift" href="/enterprise/shopify/rewards">
    Back the achievements with Shopify rewards.
  </Card>

  <Card title="Storefront widgets" icon="puzzle-piece" href="/enterprise/shopify/storefront-widgets">
    Surface the mechanics on the storefront.
  </Card>
</CardGroup>

> Last reviewed: 2026-04 · Related PRs: #1986, #2000, #2005, #2010, #2133, #2220