> For the complete documentation index, see [llms.txt](https://docs.thewalletcrew.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thewalletcrew.io/guides-animation/engage-and-animate/privilege-and-activation.md).

# Privilege & Activation

Privilege & activation covers how customer-specific benefits are reflected on a pass, and how those benefits move from "available" to "active."

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4><i class="fa-gift" style="color:$primary;">:gift:</i></h4></td><td><h3>Privilege</h3></td><td>Define customer benefits on each pass, from discounts to tiers, balances, perks, and redeemable rewards.</td><td><a href="https://2685221786-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F97ZAXMtqOjhvBBCfpmcE%2Fuploads%2F8yl3kNk17rxHvD1vap17%2Fprivilege.png?alt=media&amp;token=ca28755d-cce3-4306-9dc6-1973e439f0ef">privilege.png</a></td><td><a href="/guides-animation/engage-and-animate/privilege-and-activation/privilege.md">Privilege</a></td></tr><tr><td><h4><i class="fa-bolt" style="color:$primary;">:bolt:</i></h4></td><td><h3>Activation</h3></td><td>Trigger privileges at scale using segments, schedules, or events, then update eligible passes automatically.</td><td><a href="https://2685221786-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F97ZAXMtqOjhvBBCfpmcE%2Fuploads%2FRBFZMsKeN7lOXNQxQ2hB%2Factivation.png?alt=media&amp;token=391e6937-7b71-466f-8715-893b3010e110">activation.png</a></td><td><a href="/guides-animation/engage-and-animate/privilege-and-activation/activation.md">Activation</a></td></tr></tbody></table>

**Privilege** focuses on what a pass *displays*: tiers, statuses, discounts, points balances, or special perks tied to a customer's profile. This is the data layer — how privilege information is computed, stored, and surfaced as visible fields on the pass, and how it updates over time as a customer's status changes (e.g. moving from Silver to Gold).

**Activation** focuses on *triggering* those privileges: the mechanism that turns a stored benefit into something the customer can actually use, whether through a manual action, a pass update via the API, or a rule-based condition (purchase threshold, date, event).

Read together, the two pages cover the full path. A privilege is defined and stored on a single pass, an activation creates or updates that privilege across every pass in a segment, and each updated pass is then pushed to Apple Wallet and Google Wallet through the standard update pipeline.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.thewalletcrew.io/guides-animation/engage-and-animate/privilege-and-activation.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
