# Assign Custom Tracking Values to Partners

<a href="https://pxa.impact.com/student/activity/1117597?sid=0c0e3e5c-54c9-4435-9bee-ebcdccb7f292&#x26;sid_i=0?utm_source=app.impact.com&#x26;utm_medium=owned-platform&#x26;utm_content=tra-350&#x26;utm_campaign=help-center" class="button primary">Take the PXA course</a>

You are able to assign up to three custom values to a partner. Once the custom values are assigned, you are then able to add the values to your landing page query string. Assigning custom values to your partner helps:

* Identify the partner by name in your internal analytics dashboard.
* Specify the type of traffic associated with the partner (e.g. paid search, email, loyalty, coupon, toolbar, etc.).
* Track if you have worked with the partner through another network and want to be able to marry the data and assign the Partner ID from the other network.

{% hint style="info" %}
**Note:** When you set a custom partner value, data will start populating based on the last date you [updated the partner contract](/brand/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/modify-template-terms.md). When looking at historical data and to avoid confusion, only consider data collected after the partner value was implemented.
{% endhint %}

#### Assign custom values

1. In the left navigation menu, select ![](/files/CDnwOBeIdds9r3Z6zTnO) **\[Engage] → Partners → Partners**.
   * Alternatively, for Creator programs, select ![](/files/CDnwOBeIdds9r3Z6zTnO) **\[Engage] → Partners → Creators**.
2. Hover over the partner for whom you want to set custom values and select ![](/files/mQTDSmR70Q3Eybmgev6e) **\[More] → Tracking → Custom Values**.
3. Select the *Partner Value* field you want to set.
   * Up to three values can be set.
4. Input a value and select **Save**.

   <div data-with-frame="true"><figure><img src="/files/dIBM1UhJyk0FLQ5nO05G" alt="" width="375"><figcaption></figcaption></figure></div>

   * To view all your existing Partner Custom Values, select ![](/files/2qeX6EqajzdOPiwzfeV5) **\[User Profile] → Settings → Partner Custom values**.

{% hint style="info" %}
**Note:** Partner Custom Values correspond to the `{mp_value1}` dynamic value of the Landing Page Query String Parameters. See [Gateway Tracking Templates](/brand/what-would-you-like-to-learn-about/account-administration/program-settings/tracking-settings/gateway-tracking-templates.md) for more context.
{% endhint %}

#### Bulk edit partner custom values

Partner custom values can also be uploaded and configured in bulk with a .XLSX or .CSV file.

1. In the left navigation menu, select ![](/files/CDnwOBeIdds9r3Z6zTnO) **\[Engage] → Partners → Partners**.
   * Alternatively, for Creator programs, select ![](/files/CDnwOBeIdds9r3Z6zTnO) **\[Engage] → Partners → Creators** and in the upper-right, select ![](/files/mQTDSmR70Q3Eybmgev6e) **\[More] → Revert to old UI**.
2. In the upper-right, select **Bulk Edit**.
3. Select **Choose file** and upload a file with all of your custom values.
   * Select **Show/hide file format details** to learn more about the required file format.
   * You can also select **Copy columns to clipboard** and paste the template into a spreadsheet.

     <div data-with-frame="true"><figure><img src="/files/D9ZCPTXaiNREY91pYTZ3" alt="" width="375"><figcaption></figcaption></figure></div>
4. Select **Next**.
5. The data will load onto the *Partner Values Bulk Upload* screen with all the Partner Ids and custom values you've listed.
   * Here you can view validation errors, download the error file, and filter to show only errors or passing values.
6. Select **Accept & Create Partner Custom Values**.

#### Add custom partner values to a landing page query string

To set your partner values to the landing page query string:

1. From the top navigation bar, select ![](/files/2qeX6EqajzdOPiwzfeV5) **\[User profile] → Settings**.
2. Under the *Tracking* section, select **Gateway**.
3. Locate the *Partner Tracking Template* section.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Note:</strong> The <em>Partner Tracking Template</em> automatically appends query-string parameters to all landing pages for Partners. This is useful for passing information to a third-party analytics tool.</p></div>
4. Enter the name and custom value in the blocks provided.
   * See [Gateway Tracking Templates](/brand/what-would-you-like-to-learn-about/account-administration/program-settings/tracking-settings/gateway-tracking-templates.md) for more information.
5. Select **Save**.

   <div data-with-frame="true"><figure><img src="/files/4jZPHJOolLlMCU6Bhit6" alt="" width="563"><figcaption></figcaption></figure></div>


---

# 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://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/assign-custom-tracking-values-to-partners.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.