> For the complete documentation index, see [llms.txt](https://gift.icbest.ca/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gift.icbest.ca/giftmanager-docs/pages-and-functions/secret-santa.md).

# Secret Santa

1. **Navigate to** `/secret_santa` (admin access required).
2. **Select Participants**: Choose the participants which will be randomly picked to give a gift to another participant.
3. **Add Pool Name**: Create multiple Secret Santa pools for different groups or families. Users can be part of multiple pools simultaneously. So give it a unique name like your family name.
4. **Add Instructions**: Include details such as average price, guidelines, and any other essential notes for participants.
5. **User Revelation**: Participants will see a new icon on their dashboard. Clicking this icon takes them to their assignment page (`/secret_santa_assignment`), where they’ll find out who they’re buying a gift for and the organizer’s instructions.
6. **Ending**: To conclude a Secret Santa event, go back to `/secret_santa`, enter the pool name, and click **Delete Pool** to remove it.

**Backend:**

* Each participant's assignment is stored in `users.json` in this format:

```json
"assigned_users": {
            "pool1": "username2",
            "pool2": "username3"
}
```

* Instructions are saved in a new text file `santa_inst_<poolname>.txt` for easy reference.

<figure><img src="https://2189090169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZL6PAZpP3o7bKuehy0u9%2Fuploads%2FqkuHIKgox75V1oyMpLNQ%2Fsecret-santa.svg?alt=media&amp;token=67c0e6d0-99a2-4459-8258-97b50427016a" alt=""><figcaption><p>This icon</p></figcaption></figure>