Skip to main content
A Complete-Achievement action (#729) is a special challenge action that requires the member to have already earned a specific achievement. It gates progression.

​
How it works

Add the Complete-Achievement action to a challenge:
  1. Pick an existing achievement.
  2. Members who haven’t unlocked that achievement see a locked state on the challenge.
  3. Once they unlock the achievement (through the achievement’s normal criteria), the challenge becomes playable.

​
Why this pattern

Tutorial flows

Each tutorial challenge requires the previous one. Members finish in order.

Progression ladders

Bronze -> Silver -> Gold challenges, each gated behind the previous tier.

Prerequisite mastery

Advanced challenges require baseline knowledge (unlocked via a “completed basics” achievement).

VIP content

Gate special content behind an achievement earned through repeated engagement.

​
Creating the pattern

Create the source achievement

E.g. “Bronze Completer” — criteria: challenge_completed count >= 5.

Create a new challenge

  • New -> Challenge. Fill out basics.

Add the Complete-Achievement action

On the Content step, add a Complete Achievement action. Pick your source achievement.

Add the real content

Add the actions that make up the actual challenge content.

Publish

Members who’ve earned Bronze Completer can play. Others see the lock.

​
Layering with keys

Combine with key-gated challenges for multi-dimensional gating:
Unlock: requires 3 keys AND Bronze Completer achievement.
Members must satisfy both to play.

​
Note on stability

Earlier versions of this feature had a page-crash on action-achievement rendering (#955) — fixed. If you’re on a very old build and see crashes, force-refresh.

​
Best practices

Don’t gate every challenge. If members hit too many locked doors, they disengage. Rule of thumb: 80% open, 20% gated for progression.
Make the source achievement visible. If a member sees a locked challenge but doesn’t know how to unlock it, they give up. Link the achievement in the challenge description.