> 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/features/secret-santa.md).

# Secret Santa

1. **Navigate to** the Secret Santa page on the admin dashboard.
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`, choose the pool name, and click **Delete Pool** to remove it.

**Backend:**

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

```
"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://1258526111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8RSJkhbo9dcBVf8AwPIX%2Fuploads%2F3S1xsFOlydJ9DJq02bkc%2Fsecret-santa.svg?alt=media&amp;token=fb626349-8995-4d2f-bc02-61199af1d971" alt=""><figcaption><p><strong>This icon</strong></p></figcaption></figure>