# Donations

**URL:** https://heroiclabs.com/docs/hiro/concepts/economy/donations/
**Summary:** Donations are a way for players to share in-game items.
**Keywords:** donations, hiro
**Categories:** hiro, donations, economy

---


# Donations

![Players can request donations for Refill Tickets in Merge Chef 3D by Kyoso Interactive.]({{< fingerprint_image "/images/pages/hiro/concepts/economy/donations.png" >}})

Donations are a way for players to share in-game items, such as currencies, consumables, or collectables. Each user has their own storage object that represents the donations they have, which may be active or expired.

You can customize the donation rules to meet your social and gameplay requirements, such as restricting the number of times a user can send contributions to another user, how many donations can be active at any time, or whether donations can only be made between users who are part of a team, are friends, or have completed some other kind of gameplay together.

## Customization parameters

The following JSON represents the customization parameters you can use to configure donations for the economy system.

```json
{
  "donations": {
    "<donationId1>": {
      "cost": {
        "currencies": {
          "coins": 10
        },
        "items": {}
      },
      "count": 1,
      "description": "Description for donation one",
      "duration_sec": 10000,
      "max_count": 10,
      "name": "Donation one",
      "recipient_reward": {},
      "contributor_reward": {},
      "user_contribution_max_count": 2,   
      "additional_properties": {
        "<propertyName>": "value"
      }
    }
}
```

Each individual donation is keyed by id and may define the following:

### Donation

{{< table name="gdk.concepts.economy.donation" >}}

### Donation Cost

{{< table name="gdk.concepts.economy.donation-cost" >}}