# Gifts (Freebies)

Adding gifts (freebies) helps clearly showcase promotional offers, enhance user experience, increase purchase conversion rates, support flexible promotional strategies, and enable precise inventory management, all while boosting brand image.

Gift freebies preview:

{% embed url="<https://ascent-vortex.myshopify.com/products/mechanical-keyboard-rainbow-backlit>" %}

<figure><img src="https://3086053958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUtxdyhQYbUmYMEm4SSNh%2Fuploads%2FzDgERxNeZQ1Fx9XTalJt%2Fimage.png?alt=media&#x26;token=b3f0ecfe-d243-429f-a929-08cd26356cb2" alt=""><figcaption></figcaption></figure>

### Step 1: Create a Gift Metaobject

<figure><img src="https://3086053958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUtxdyhQYbUmYMEm4SSNh%2Fuploads%2FZJxhzUtEaPh93AEShAw7%2F%E5%BD%95%E5%B1%8F2024-12-31%20%E4%B8%8B%E5%8D%8812.11.06.gif?alt=media&#x26;token=03772e65-a5a4-40e5-8b84-c29cf8666d7f" alt=""><figcaption></figcaption></figure>

Go to the **Metafields** configuration page.

1. Add a new **Metaobject** and name it "gift" (the name can be customized).
2. Ensure that this **Metaobject** contains the following three fields:

   * **image** (Select file type; Select images.): Used to upload the gift image.

   <div align="left"><figure><img src="https://3086053958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUtxdyhQYbUmYMEm4SSNh%2Fuploads%2FCESvsEJiKmPjHlEjbIMn%2Fimage.png?alt=media&#x26;token=59443ec5-da07-4de1-a4c1-2c76f6eeb9fa" alt=""><figcaption></figcaption></figure></div>

   * **title** (Single line text type): Used to enter the gift’s name.

   <div align="left"><figure><img src="https://3086053958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUtxdyhQYbUmYMEm4SSNh%2Fuploads%2Fjvx0I1GiEObbmLx6tf5x%2Fimage.png?alt=media&#x26;token=5f501bdd-a062-443d-8f15-ff66b6a52828" alt=""><figcaption></figcaption></figure></div>

   * **price** (Money type): Used to set the price of the gift.

   <div align="left"><figure><img src="https://3086053958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUtxdyhQYbUmYMEm4SSNh%2Fuploads%2FXOHMnw2j60F0qxqnEJaB%2Fimage.png?alt=media&#x26;token=2ebc3d9f-b2e8-4d8d-af1a-945f55f79f14" alt=""><figcaption></figcaption></figure></div>

### **Step 2: Add Gift Entries**

<figure><img src="https://3086053958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUtxdyhQYbUmYMEm4SSNh%2Fuploads%2FOHWE33EOhd0evJAkbXKI%2F%E5%9B%BE%E7%89%87.png?alt=media&#x26;token=929bba38-b1a0-4e3c-aa38-55f0a104637f" alt=""><figcaption></figcaption></figure>

1. In the "gift" **Metaobject**, add multiple entries, with each entry representing a separate gift.
2. For each entry, upload the **image**, and fill in the gift’s **title** and **price**.

### **Step 3: Add Gifts to Products or Product Variants**

1. **Add a gift to the product**

{% hint style="success" %}
If a gift is added to a product, it will apply to all variants of that product.
{% endhint %}

<figure><img src="https://3086053958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUtxdyhQYbUmYMEm4SSNh%2Fuploads%2FEzEK5gB5khxF8KZPYu62%2F%E5%9B%BE%E7%89%87.png?alt=media&#x26;token=8ac2e868-f671-4779-bd1c-a3601c4e2573" alt=""><figcaption></figcaption></figure>

* Open the Metafield configuration page and add a new product metafield named `product-gift`, ensuring the namespace and key are set to `custom.product_gift`.
* Set the Metafield type to "Metaobject," reference the previously created `gift` metaobject, and choose the **List of entries**.
* On the product editing page, locate the "Product Metafields" section, find the `product-gift` Metafield, and select the desired gift entries to add.

<figure><img src="https://3086053958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUtxdyhQYbUmYMEm4SSNh%2Fuploads%2FV7eSP6vEaSjvAarumYFr%2F%E5%9B%BE%E7%89%87.png?alt=media&#x26;token=f8da945b-e51d-4915-8567-bcc38d922dbc" alt=""><figcaption></figcaption></figure>

2. **Add a gift to a specific product variant:**

   * Open the Metafield configuration page and add a new product variant metafield named `variant-gift`, ensuring the namespace and key are set to `custom.variant_gift`.
   * Set the metafield type to "Metaobject" and reference the previously created `gift` metaobject, selecting the list type.
   * On the product editing page, go to the "Variants" section, select the specific variant you want to add a gift to, and open the variant editing page.
   * In the variant editing page, locate the "Metafields" section, find the `variant-gift` metafield, and select the desired gift entries.<br>

### Step4: In the product page template, add a gift block.

{% hint style="success" %}
You can place the gift block anywhere you want on the product page. If no gifts are added to the product, the gift block will not be displayed.
{% endhint %}

<figure><img src="https://3086053958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUtxdyhQYbUmYMEm4SSNh%2Fuploads%2FTDhmq82CbX6pwIl0bkYb%2F%E5%BD%95%E5%B1%8F2024-12-31%20%E4%B8%8A%E5%8D%8811.59.48.gif?alt=media&#x26;token=03d4a0b2-4ad6-4617-9d00-458f68138f02" alt=""><figcaption></figcaption></figure>

### **Important Notes**

* A maximum of 6 gifts can be added to each product or variant.
* Ensure that the metafields are configured correctly to make it easy to select and add gifts during future operations.