Received claimed gifts – what's the right way to handle it?

[deso85]

Hi there,

before I open a feature request, I just want to make sure I correctly understand how the "claim" feature works.

Recently, I received some gifts that were part of a wishlist. In the details tab of some items, I noticed that they had been claimed.

Now I'm unsure how to proceed:

• Should I manually reduce the quantity of those items or delete them entirely to reflect that they've been gifted?
• Or is there a way to mark a claimed item as received, so the system updates accordingly?
  What if the item has a quantity greater than one and only part of it was claimed? Can I specify how many I received and who gifted them, so the system correctly matches it with existing claims?
• What happens if I delete a claimed item?
  – Will that cause an error?
  – Will it disappear from the claimer’s view?
  – Will the claimer be notified in any way (e.g., that I changed my mind)?

Thanks in advance for your help — and for providing this great tool!

[cmintey]

Hey! Just curious, is this a registry or public list you're talking about? Otherwise not sure how you would have seen if an item is claimed...

Anyways, after an item has been claimed and you've received the item, you can either

1. Leave the item alone, no one will be able to also claim it (though it won't prevent anyone from just buying it anyways)
2. Delete the item entirely. There should be no errors with this. The person who claimed the item would just see this disappear and wouldn't be notified (this is something I've thought about implementing though)
3. Within the admin or group settings page, there are so-called "Actions" which lets you clear all claimed items. If you use this button, then items that have been fully claimed will be deleted and items that have been partially claimed will have their quantity automatically reduced to the remaining amount and the existing claims will be deleted.

There is no way to mark an item as "received" but there is an open feature request to archive an item rather than fully deleting it, but I haven't fully thought that through yet.

Hopefully that clears things up, let me know if there are any additional questions!

[deso85]

Hi, thanks again for the quick reply!

Yes, I'm self-hosting Wishlist and have invited a handful of users. When I view items on my list, I can see how many have been claimed — I assume that's because all users are registered and part of the same group.

Your explanation was helpful, but I still feel that the claim-related workflows could use a bit more refinement — and I mean that in the most constructive way. 😊

From my experience, the real-world usage is often messier than the system expects:

• People forget to claim items before buying them
• Some claim, but don’t end up gifting the item
• Others tell you afterwards what they got
• Some might claim something, but never mark it as purchased, which prevents the admin "clear claimed items" action from working properly
• Some people give something that’s on the list without ever interacting with the app at all

Because of that, relying solely on claims can lead to mismatches between the app and reality. The “clear claimed items” action is a helpful tool, but depending on how disciplined your users are, it might not always clean things up the way you'd expect.

Idea: "Mark item as received"

I think it would be very useful to have a way to manually mark an item (or part of it) as received. Ideally, this would allow the list owner to:

• Reduce the quantity of the item
• Associate the gift with a user from the group or enter a free-text name if the giver is not registered
• Automatically remove an existing claim from that user, if one exists
• (Optionally) move the received item into a personal archive or "received gifts" list, including the giver’s name, the date received, and an optional note
  → This way, the active wishlist stays clean, while a history of past gifts can be kept for reference — if enabled

This would help in a number of ways:

• The active wishlist stays clean and focused on current wishes
• Gifts that have been received don’t just vanish, but can (optionally) be archived with context: who gifted them, when, and any additional notes
• Claims still serve their purpose but are no longer the only mechanism to reflect what’s been gifted
• The app becomes more resilient to human error — such as missing or incorrect claims
• Over time, the archive of received gifts might even become a useful reference (e.g. for thank-you notes, or to avoid duplicate gifts in the future)

I imagine this could be a small popup/modal that lets the user mark one or more items as received and optionally link them to a giver (registered or not). Removing an existing claim would be a helpful side effect — but not required for the feature to be useful.

Let me know what you think — does this idea fit within your vision for Wishlist, or would parts of it need to be reconsidered?

Thanks again for building and maintaining this project — it’s a fantastic tool, and I really enjoy using it.