# Catalogs

Our **Catalogs** feature allows you to link a **product list or feed** to your campaigns.\
With this setup, you can assign different commission rates to each product and create payouts based on the catalog. This means affiliates can earn varying commissions depending on which products their referred clients purchase.

**You can also choose to share the product list with your affiliates.**\
Affiliates will be able to download the list of products. When a product URL is specified, the list will contain the affiliate's unique tracking link that will redirect potential customers directly to the corresponding product page.

Product feeds can be added in two ways:

1. Manually upload a CSV file containing the product list details and commissions
2. Add a link to a live updating XML or JSON product feed

{% hint style="info" %}
If your live product feed doesn't include the affiliate commission values, you will need to input them manually for each product.
{% endhint %}

***

### Uploading a CSV Catalog

Navigate to **Campaigns** → Locate the relevant campaign → click the three-dot icon under the **Actions** column → **Edit** → **Catalogs** → **Add New** → Fill out the catalog details → **Save**

<figure><img src="https://1097958070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHX682uo79XLNkfkN58br%2Fuploads%2FOupjRKFVWJ5uAV1Q01Gs%2Fchrome_O0O5GZtm9H.gif?alt=media&#x26;token=a2e4e96c-5fe0-4890-a45f-e289c68e5818" alt=""><figcaption></figcaption></figure>

| Field                | Description                                                                                                                                                    |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**             | Specify a name for your catalog                                                                                                                                |
| **Description**      | Provide a description for the catalog                                                                                                                          |
| **Private**          | Toggle **off** to make this catalog available to all affiliates. Toggle **on** to restrict access and select the specific affiliates who can view this catalog |
| **Enable Live Sync** | Toggle off to upload a CSV catalog                                                                                                                             |

Once the catalog is created, click the three dot icon under the **Actions** column next to the catalog and click **Import Items**

<figure><img src="https://1097958070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHX682uo79XLNkfkN58br%2Fuploads%2Fc2THGv475OcisbDOOCe3%2Fimage.png?alt=media&#x26;token=fedfffb4-9819-416a-a849-dd96407738b7" alt=""><figcaption></figcaption></figure>

Download the sample file to review the required format, then upload your completed CSV file accordingly

<figure><img src="https://1097958070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHX682uo79XLNkfkN58br%2Fuploads%2FtL2O6hMDWsEJkyOHhRMv%2Fimage.png?alt=media&#x26;token=dc01ccdb-e7d5-4e55-8cc8-c990987d4c79" alt=""><figcaption></figcaption></figure>

***

### Uploading a Live Catalog Feed

Navigate to **Campaigns** → Locate the relevant campaign → click the three-dot icon under the **Actions** column → **Edit** → **Catalogs** → **Add New** → Fill out the catalog details → **Save**

<figure><img src="https://1097958070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHX682uo79XLNkfkN58br%2Fuploads%2FOupjRKFVWJ5uAV1Q01Gs%2Fchrome_O0O5GZtm9H.gif?alt=media&#x26;token=a2e4e96c-5fe0-4890-a45f-e289c68e5818" alt=""><figcaption></figcaption></figure>

| Field                | Description                                                                                                                                                    |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**             | Specify a name for your catalog                                                                                                                                |
| **Description**      | Provide a description for the catalog                                                                                                                          |
| **Private**          | Toggle **off** to make this catalog available to all affiliates. Toggle **on** to restrict access and select the specific affiliates who can view this catalog |
| **Enable Live Sync** | Toggle on to upload a live catalog                                                                                                                             |

Once Live Sync is enabled, specify:

1. Sync Period
2. Feed URL (if your endpoint requires any headers you can add them as well)
3. Input the **tag/field name** representing items in the JSON/XML file&#x20;
4. Select the **type of file (JSON/XML)**

<figure><img src="https://1097958070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHX682uo79XLNkfkN58br%2Fuploads%2FxrBUKxc0TzrQzD6xLXfV%2Fimage.png?alt=media&#x26;token=f3391736-bbd3-4aba-9dd2-51d3af31b912" alt=""><figcaption></figcaption></figure>

Click **Next** to proceed to the mapping step.

Our system will parse the product feed and try to map the various properties each product has. Use the mapping feature to associate the relevant properties with the corresponding fields.

You can then preview the data and save the mapping.

<figure><img src="https://1097958070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHX682uo79XLNkfkN58br%2Fuploads%2FyjipPjEVGYoYTrvD08dG%2Fimage.png?alt=media&#x26;token=51be91c1-926a-49df-8d93-77fbd881f00a" alt=""><figcaption></figcaption></figure>

Click **Save** to create the catalog