Secret Santa Generator Documentation
The Secret Santa Generator makes organizing gift exchanges effortless. Whether you’re planning a holiday party at work, a family gathering, or a friend group exchange, this free tool handles all the complicated parts: random pairing, two-way draw restrictions, keeping assignments secret, and distributing invitations to everyone.
No more drawing names from a hat or risking spoiled surprises. Create your Secret Santa event in under 2 minutes, and each participant gets a personalized link to view their assignment privately. Everything stays organized, trackable, and completely confidential.
Note: you can start creating your free Secret Santa event here: Free Secret Santa Generator
Table of Contents
Creating Your Secret Santa Event
Setting up a Secret Santa event takes three guided steps: add participants, optionally set draw restrictions, then enter event details. After you click “Create Secret Santa,” you’re sent straight to the organizer page where you can share invite links and manage everything.
Step 1: Participants
Start by adding everyone who will participate in your gift exchange. You need a minimum of 3 participants and can have up to 100 in a single event.
How to add participants:
- Type each participant’s name in the input field
- Press Enter or click the plus (+) button to add another row
- Drag the grip handle on the left to reorder names
- Click the trash icon to remove someone
Important notes:
- Minimum 3 participants required to continue
- Maximum 100 participants per event
- Each name field accepts up to 100 characters
- Email addresses are added later in the organizer view (the create flow only takes names)
Click “Continue” to move on to draw restrictions.
Step 2: Restrictions (Optional)
This step lets you prevent specific people from drawing each other (couples, roommates, anyone who shouldn’t be paired). Restrictions are completely optional — you can also skip the step.
Choose “Yes, I want to set draw restrictions” to reveal the participant list. Click any participant’s row to open the restriction modal.
In the modal, check the people the selected participant should NOT draw. Then click “Save Restrictions.”
- Two-way enforcement — if Alice can’t draw Bob, then Bob automatically can’t draw Alice either
- Restriction count appears next to each participant (e.g. “1 Restriction”)
- The constraint solver runs when you create the event — if your restrictions make pairing impossible, you’ll see an error and can loosen them
- Click “Skip This Step” or choose “No, skip this step” to bypass restrictions entirely
Step 3: Event Details
Configure the occasion and information that participants will see.
What do you want to draw names for?
Pick the occasion. The tool auto-selects the next upcoming holiday based on today’s date and pre-fills a sensible group name. The available occasions are:
- Secret Santa
- Christmas
- Hanukkah
- Thanksgiving
- New Year’s Eve
- Valentine’s Day
- Christmas in July
- Eid
- Kwanzaa
- Eid al-Adha
- Diwali
- Halloween
- Purim
- Father’s Day
- Mother’s Day
- Easter
- Other (custom event name)
Required fields:
- Organizer Name — your name (or company name) as it will be shown to all participants
- Group Name — the name of your event. Quick suggestion chips include “Secret Santa [year]”, “Christmas [year]”, “Holiday Gift Exchange”, “New Year [next year]”, and “Office Secret Santa” — click any chip to fill the field instantly
Optional fields:
- Gift Exchange Date — date picker (defaults to no date)
- Gift Budget — suggested spending amount per gift, with a currency dropdown of USD ($), EUR (€), GBP (£), CAD (C$), and AUD (A$)
- Add Custom Message — tick the checkbox to reveal a textarea (up to 1000 characters) for instructions, theme suggestions, or rules participants will see on their reveal page
Once both required fields are filled, the form shows a green confirmation: “✓ All required information provided.” Click “Create Secret Santa” to generate the pairings.
The constraint solver assigns each participant a recipient (respecting any restrictions you set) and you’re redirected directly to the organizer page.
Managing Your Event
The organizer page is your single command center: share invite links, track who’s seen their match, edit details, manage participants, and (if needed) override the auto-generated pairings.
Organizer View
Right after you create the event you see a “Secret Santa created — X participants paired” success banner. The page is laid out as one scrollable view titled “How to Run Your Secret Santa”.
What you’ll see, top to bottom:
- Anonymous-user banner (only when you’re not signed in) with your management link and an inline form to save the event to a free Uplup account — bookmark or copy this link, lose it and you lose access
- Event title bar showing your group name, participant count, exchange date (if set), and an “Edit” button to change details
- Step 1 — Share this link with your group: a single universal invite link with Copy Link and WhatsApp share buttons
- Step 2 — Track who has seen their match: a viewing-progress bar (e.g. “0 of 5 viewed”)
- Participants / Pairings tabs at the bottom for per-person link copying and (optional) pairing reveal
Sharing Invitations
The Secret Santa Generator gives you two ways to share assignments, plus a bulk email tool. There are no separate “send to all” buttons on a success screen — everything happens on the organizer page.
Option 1: Universal Link
Featured at the top of the organizer view (“Step 1: Share this link with your group”). One link works for everyone in the event.
- Each participant clicks the link, picks their own name from the list, optionally adds gift preferences, and sees their match
- One-click Copy Link and a green WhatsApp share button
- Best for group chats (WhatsApp, Slack, Discord, iMessage) where everyone is already together
Option 2: Individual Links
Available in the Participants tab at the bottom of the organizer view. Each participant has a unique URL.
- Click the “Get Link” button next to a participant to copy that person’s unique link
- Each row shows a “Viewed” or “Not Viewed” status badge
- Best for professional environments, larger groups, or when you want to track who has and hasn’t checked their assignment
Participants and Pairings Tabs
At the bottom of the organizer view there are two tabs:
Participants tab — the default. For each person you see:
- Their colored avatar initial and name
- Their email address (if added)
- A Viewed or Not Viewed status badge
- A Get Link button to copy that participant’s unique invite URL
Pairings tab — hidden by default with a “Pairings are hidden” placeholder and a Reveal Pairings button. This is intentional: only reveal if you genuinely need to see who got whom.
- Once revealed, you see the full giver → receiver list (e.g. “Alice gives to Bob”)
- Each row shows whether that participant has viewed their match
- An Edit Pairings link below the list opens a modal where you can manually override matches
- A “Hide pairings” link returns to the protected state
Pairings should stay confidential. Never share this view with participants.
Editing participants and adding emails: Use the “Edit” button in the title bar (or the Manage Participants modal accessed from there) to add email addresses, rename participants, or remove people. Email addresses are required for sending bulk email invitations.
Sending Bulk Emails
If your participants have email addresses on file, you can email them all (or a selection) their unique invite link in a few clicks. Bulk email sending requires being logged in to a free Uplup account.
What gets sent: each selected participant with an email address receives a personalized invitation email containing their unique Secret Santa assignment link.
Rate limit:
- Up to 25 total emails per 24 hours (single + bulk combined)
- Helps prevent spam and protect deliverability
- If you select more than the remaining cap, you’ll see a “Too Many Selected” warning telling you exactly how many to deselect
Today’s Email Usage panel shows in real time:
- Emails sent today
- Remaining today
- Single emails sent
- Bulk emails sent
- A progress bar against the daily cap
Selecting participants:
- Each participant has a checkbox; participants without an email address are grayed out and disabled with a “No email address” note
- The toggle button in the header switches between Select All and Deselect All
- The selection counter (“X selected”) updates as you check boxes
- The send button is labelled “Send Emails (X)” with the live selection count, and is disabled when nothing is selected or you’re over the cap
Dashboard (Logged-In Users)
If you save the event to a free Uplup account, your Secret Santa events appear in the brand dashboard alongside any forms or quizzes you’ve built.
- The dashboard’s filter tabs include All, Forms, Quizzes, and Secret Santa — click “Secret Santa” to see only your gift exchanges
- Each event card shows its name, participant count, exchange date, and viewing percentage
- Click any card to jump back into the organizer view for that event
- Anonymous events created in the same browser are auto-claimed when you sign in (a 1-year cookie tracks them)
Participant Experience
When participants click their invite link (universal or individual), here’s what they go through.
Universal Link Flow
- Click the universal link
- See the list of participants in the event
- Pick their own name
- Optionally add up to 5 gift preferences and an email (so their Secret Santa can be notified later)
- Reveal their assignment with a confetti animation
Individual Link Flow
- Click their personalized link
- Their name is pre-selected; they confirm it’s them
- Optionally add up to 5 gift preferences and an email
- Instantly see their Secret Santa assignment
The Profile & Management Page Experience
After confirming their identity (and optionally adding preferences), participants land on a secure, bookmarkable profile page. On first visit they see a confetti animation and a prompt to bookmark the URL.
What’s on the profile page:
- Who they’re buying a gift for
- Event details: organizer name, group name, exchange date (if set), and gift budget (if set)
- The custom message from the organizer (if added)
- Their assigned person’s gift preferences (if provided), shown as priority-ranked cards
- An “Update Your Preferences” button to edit their own gift ideas or add an email later
- A Download button to save assignment details as a text file
Gift Preferences (if provided):
- #1 Top Choice — the first preference is highlighted with a gold “Top Choice” badge and a prominent “Shop Top Choice on Amazon” button
- #2 onward — each additional idea is shown with a numbered badge and its own “Shop on Amazon” button
- Budget-aware Amazon links — Amazon search URLs include the event’s budget cap when one is set
- Email notifications — if a participant added an email, they’re notified when their assigned person first adds gift preferences
Preference cards display in a responsive grid (up to 3 cards per row on desktop, fewer on mobile).
Browse gift categories:
Below the preferences, the profile page shows 12 curated Amazon shopping categories with photography and budget-filtered links:
- Today’s Deals — current sales and promotions (marked with a “HOT” badge)
- Best Sellers — top-rated popular items
- Tech & Gadgets — cool tech finds
- Home & Decor — cozy home gifts
- Fashion — style essentials
- Beauty — pamper and glow gifts
- Kitchen — cook and dine
- Books — great reads
- Wellness — self-care essentials
- Toys & Games — fun for all ages
- Sports — active lifestyle gifts
- Jewelry — elegant accessories and watches
Categories are displayed in a responsive grid (2–4 columns depending on screen size).
Note: the category links are Amazon affiliate links. Purchases through these links help keep the Secret Santa Generator free at no extra cost to you.
Adding their own gift preferences:
Before revealing their assignment, participants are invited (optionally) to list up to 5 gift ideas of their own. They can search Amazon products inside the form or type free-text ideas. Preferences can be updated anytime later via the bookmarkable profile page.
Gift preferences can include:
- Specific items (e.g. “Blue coffee mug”, “Wireless headphones”)
- Categories or hobbies (e.g. “Books”, “Gardening supplies”, “Skincare”)
- Amazon products selected from the in-form search results
The first preference is automatically highlighted as “Top Choice” when their Secret Santa views it. When a participant adds preferences for the first time, their Secret Santa is auto-notified by email (if their Secret Santa supplied an email address).
Privacy and security:
- Each participant only ever sees their own assignment
- They cannot see other pairings
- Each profile link is secured with a unique token
- Universal-link selection still produces a unique per-person profile URL after the reveal
Best Practices
Before Creating Your Event
- Collect names and (ideally) email addresses ahead of time
- Decide on a budget and exchange date so the event details are useful
- List exclusions to set — couples, roommates, recent recipients — before you start, so step 2 goes quickly
During Setup
- Use a clear group name — click one of the suggestion chips or type your own (e.g. “Office Secret Santa 2026”)
- Add restrictions early if you have couples or roommates — remember restrictions are two-way automatically
- Write a custom message with theme suggestions, wish-list instructions, or exchange logistics
- Double-check participant names for typos before generating pairings
Gift Preferences
- Encourage participants to fill in preferences — up to 5 each, with the first one becoming the “Top Choice”
- Suggest adding email addresses — participants who do are emailed when their assigned person first adds gift ideas
- Be specific but flexible — “Stainless steel water bottle” works better than just “water bottle”
- Keep budget in mind — the Amazon links are filtered by your event’s budget when one is set
- Remind participants to bookmark their profile page — that’s how they return to update preferences or check for updates
Sharing Invitations
- For professional settings: use individual links from the Participants tab so you can track who has and hasn’t viewed
- For friends/family: the universal link in a group chat works great
- For email-friendly groups: sign in to a free Uplup account and use bulk emails (up to 25/day combined cap)
- Send reminders: use the viewing-progress bar and the per-row “Not Viewed” status to follow up
Managing the Event
- Don’t reveal the Pairings tab unless you absolutely need to — that’s why it’s hidden by default
- Use Edit Pairings sparingly — it’s there for emergencies (someone drops out, the constraint solver picked something awkward), not as a default workflow
- Save anonymous events to an account — use the inline email capture banner so you don’t lose access if you clear cookies
Troubleshooting
If someone loses their link: open the Participants tab, click Get Link next to their name, and resend it.
If you need to add or remove someone after creation: use the Edit button in the title bar (Manage Participants) to add, remove, or rename people. Use Edit Pairings if you need to manually re-route who gives to whom.
If emails aren’t arriving: check spam folders, verify the address is correct in the Participants list, share via WhatsApp instead, or fall back to the universal link.
If pairing fails because of restrictions: the constraint solver will return an error if your restrictions make a valid Secret Santa impossible. Loosen one or two restrictions and try again.
The Secret Santa Generator takes the stress out of organizing gift exchanges. With a constraint-aware solver, two-way draw restrictions, universal and per-person invite links, gift preferences, and bulk email tools, you can focus on the fun part: watching everyone enjoy the surprise of Secret Santa.
Ready to create your event? Start your free Secret Santa Generator now