# 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="/files/eyloqEtw3AIKo9KIaJPz" 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="/files/QIhFlc6mHhBh7GL3vYe1" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/5g4JrSDCrVzvVj5UwV9c" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/KCnrulR4Sv87qbeEZBAn" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="197">Field</th><th width="93">Type</th><th>Description</th></tr></thead><tbody><tr><td>Item ID <strong>(Required)</strong></td><td><code>String</code></td><td>The ID of item in the store (SKU)</td></tr><tr><td>Name <strong>(Required)</strong></td><td><code>String</code></td><td>The name of the item</td></tr><tr><td>Description <strong>(Optional)</strong></td><td><code>String</code></td><td>A description of the item</td></tr><tr><td>Default Affiliate Commission <strong>(Required)</strong></td><td><code>Integer</code></td><td>Affiliate commission (percentage): Enter the commission as a percentage of the item price. For example, type 25 if the commission is twenty-five percent. <strong>(Do not include the % symbol)</strong></td></tr><tr><td>Default Merchant Commission <strong>(Optional)</strong></td><td><code>Integer</code></td><td>Merchant commission (percentage): Enter the commission as a percentage of the item price. For example, type 50 if the commission is fifty percent. <strong>(Do not include the % symbol)</strong></td></tr><tr><td>Coupon <strong>(Optional)</strong></td><td><code>String</code></td><td>A coupon code relevant to this item <strong>(Informative only, does not trigger any commission logic)</strong></td></tr><tr><td>Price <strong>(Required)</strong></td><td><code>Integer</code></td><td>Item price: Enter only the numeric value of the item price, without the currency. For example, if the price is 1099 USD, enter 1099. If your campaign uses a different currency, convert the amount first and then enter the converted number only.</td></tr><tr><td>Link <strong>(Optional)</strong></td><td><code>String</code></td><td>A URL to the product/product page.</td></tr><tr><td>Image Link <strong>(Optional)</strong></td><td><code>String</code></td><td>A URL to the product image.</td></tr></tbody></table>

***

### 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="/files/eyloqEtw3AIKo9KIaJPz" 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="/files/uNsxZvfeHN9el5JhAklC" 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="/files/VdZmNulPf58uVgA0PG7i" alt=""><figcaption></figcaption></figure>

Click **Save** to create the catalog


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tracknow.io/campaigns/catalogs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.