Received Gifts
The Received gifts page is where the list owner sees what they actually got: the items their giftgivers claimed, who claimed each one, and any add-ons giftgivers volunteered along the way. Until the reveal happens, this page is empty for an item.
How an Item Gets Here
Section titled “How an Item Gets Here”Items show up on Received gifts when both conditions are true:
- Someone has claimed the item (created a
giftedItemsrow). - The item has been archived (its
isArchivedflag is set to true).
Archive is the visibility trigger. Until archive, the list owner sees a normal list - no badges, no claimer names, no spoilers. After archive, the claim data becomes visible.
Two things can flip the archive:
- You archive it manually from the list. This is the “I’ve already opened this gift, show me who gave it” action.
- The auto-archive cron flips it on a schedule per list type. See Claims and reveal for the per-type defaults; admins tune the offsets at
archiveDaysAfter*.
What Shows Up on Each Entry
Section titled “What Shows Up on Each Entry”| Field | Source |
|---|---|
| Item | Title, photo, price, your original notes. |
| Gifter | The user who claimed it (or first claimer for split claims). Renders avatar + name. |
| Co-gifters | Other users listed in the claim’s additionalGifterIds. |
| Total cost | Optional. Some gifters record what they actually paid; some don’t. |
| Gifter notes | Optional. Anything the gifter wanted you to know (“got it on sale”, “the green one was sold out so I went with blue”). |
| Quantity | For items where multiple people claimed partial quantities, each claim is its own row. |
If your partner was a co-gifter or claimed it, they’re credited too - that’s how partner-shared gift credit works on the receiving side as well.
List Add-Ons
Section titled “List Add-Ons”Below your items, the Received gifts page surfaces list add-ons: extra gifts giftgivers volunteered that weren’t on your original list. Each add-on shows:
- The title and description the gifter typed.
- The gifter (or co-gifters).
- An optional photo and URL.
Add-ons only appear on Received gifts, never on the normal list view. You can decide whether to add an add-on to a future list, send a thank-you for it, or just acknowledge it - GiftWrapt doesn’t enforce a workflow.
Dependents
Section titled “Dependents”When a list has a dependent as its subject, the Received gifts view for that list’s guardian still shows everything correctly attributed - the dependent’s identity renders as the recipient, the guardian’s identity renders nowhere (they’re the list manager, not the recipient).
A dependent never sees a Received gifts page of their own (they don’t have an account). Their guardians see one per dependent they manage.
Why No “Received-At” Timestamp?
Section titled “Why No “Received-At” Timestamp?”There’s no dedicated reveal timestamp on items. The Received gifts query uses items.updatedAt as a proxy for “archived at,” which works because the archive write is the most recent change for an archived item.
If your deployment ever needs an exact reveal time (audit, accounting), treat that as a new column - don’t overload updatedAt.
Privacy
Section titled “Privacy”The recipient can always see claim data for items they’ve revealed. That’s the whole point. But the page never exposes things the recipient shouldn’t see:
- Other people’s restricted-filtered claims stay hidden (Received gifts is owner-facing, where the Restricted filter doesn’t apply, but the principle holds for any future cross-user view).
- Pending unclaimed items don’t show up here. The page only renders archived items with at least one claim.
Where to Find It
Section titled “Where to Find It”The user menu has a Received link, or go directly to /me/received.