# Giveaways

> You can use giveaway pools to store codes or vouchers generated outside of Talon.One with which to reward your customers.

> For the complete documentation index, see [llms.txt](https://docs.talon.one/llms.txt).

For example, you can send customers Amazon gift cards when they spend a certain amount or
[join a new tier in a loyalty program](/docs/product/loyalty-programs/overview.md).

To use giveaways in [the effects of your rules](/docs/product/rules/effects/available-effects.md#incentives):

1. [Activate the giveaway feature](/docs/product/campaigns/settings/manage-campaign-features.md)
   in your campaign.
1. Create a giveaway pool and connect it to the Application that contains your campaign.
1. Import giveaway codes into the pool.

## Giveaway pool environments

You can create giveaway pools in one of the following environments:

- Sandbox
- Live

They help you differentiate between testing and production giveaway pools.

Giveaway pools from a given environment can only be connected to
[Applications from the same environment](/docs/product/applications/overview.md#application-environments).
For example, if a giveaway pool is created in the sandbox environment,
it cannot be accessed in the live environment.

## List giveaway pools

To list your giveaway pools, on the leftmost menu, click **Incentives** > **Giveaways**.

The page that opens displays the available giveaway pools.
It contains the following information for each of them:

| Column       | Description                                                                                                 |
| ------------ | ----------------------------------------------------------------------------------------------------------- |
| ID           | Unique number identifying the giveaway pool. It is used for integration purposes.                           |
| Environment  | [Environment](#giveaway-pool-environments) of the giveaway pool.                                            |
| Pool         | Name and description of the pool.                                                                           |
| Applications | Number of Applications the pool is connected to.                                                            |
| Actions      | Options to <Edit className="icon" /> [edit][edit] or <Delete className="icon" /> [delete][delete] the pool. |

## Display a giveaway pool

To view the details and codes of a giveaway pool,
on the <Giveaways className="icon"/> **Giveaways** page, click its name.

The page that opens displays the name and description of the giveaway pool
along with the following information:

- **Giveaway Pool ID**: Unique number identifying the giveaway pool. It is used for integration purposes.
- **Last Update**: Date and time when the pool was last modified.

In the **Giveaway Codes** section, the page displays the following information
about the codes of the giveaway pool:

| Column                  | Description                                                                                                                                                                         |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Code                    | The giveaway code, for example, a gift card redemption code.                                                                                                                        |
| Awarded                 | Award status of the code. <Check className="icon" /> means awarded. <Cross className="icon" /> means not awarded.                                                                   |
| Customer Integration ID | ID of the customer who was awarded, if the giveaway was awarded.                                                                                                                    |
| Created                 | Date and time when the giveaway code was created.                                                                                                                                   |
| Awardable From          | Date and time from when the code can be awarded. The code provider can still determine whether the code can be redeemed.                                                      |
| Awardable Until         | Date and time from when the code can no longer be awarded. The code provider can still determine whether the code can be redeemed.                                            |
| Attributes              | Name and value of the connected [custom attributes][attributes] with associated entity **giveaway**. Learn more about this in the [Developer docs][setting-attribute-values]. |

## Related pages

- [Manage campaign features](/docs/product/campaigns/settings/manage-campaign-features.md)
- [Award a giveaway as an effect](/docs/product/rules/effects/use-effects.md#award-a-giveaway)
- [Rewards](/docs/product/rewards/overview.md)

[edit]: /docs/product/giveaways/manage-giveaways.md#edit-a-giveaway-pool
[delete]: /docs/product/giveaways/manage-giveaways.md#delete-a-giveaway-pool
[attributes]: /docs/product/account/dev-tools/manage-attributes.md
[setting-attribute-values]: /docs/dev/tutorials/create-giveaways.md#set-custom-attributes