> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/promo-codes/manage-your-promo-codes.md).

# Manage Your Promo Codes

When managing promo codes, you can perform actions such as *Expire*, *Download*, *Change active dates*, and more. This article guides you through performing these actions.

1. From the left navigation menu, select ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → Content →** [**Promo Codes**](https://app.impact.com/secure/advertiser/engage/ads/view-adv-promo-codes-flow.ihtml).
2. Use the filters to find specific resources. Refer to the *Filter reference* table below.
3. Hover over the promo code, then select the ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b5e1740618ed6571d97b8fed7c25a7678f85d375%2F299632fb6f4f91fbf9847471754cc6180e4284a65b4960af4c4ea472a159f552.svg?alt=media) **\[Unchecked box]** on the left and choose one of the following:
   * Select **Apply Deal** to incorporate a [deal](/brand/what-would-you-like-to-learn-about/platform-features/deals/deal-types-overview.md) from the ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[Drop-down menu]**.
   * Select **More actions** to choose an action. Refer to the More actions reference table below.
4. Select ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FxFDYIXnntoj76xzm1CXr%2FColumns.svg?alt=media\&token=001578cd-38da-4ecc-98e9-f8f461e61ff2) **\[Columns]** on the right of the screen to add or remove columns from the table.
   * See the *Columns reference* below for more information.

<details>

<summary>Filter reference</summary>

<table><thead><tr><th width="179.57421875">Filter</th><th>Description</th></tr></thead><tbody><tr><td>Search bar</td><td>Optionally, use the search bar to find a promo code by <em>Name</em>.</td></tr><tr><td>Partner</td><td>Select <strong>Partner</strong> to filter for promo code applicable to a specific partner.</td></tr><tr><td>Code Schedule</td><td><p>• <strong>All</strong>: View promo codes in all statuses.</p><p>• <strong>Pending Promo Codes</strong>: Promo codes which have been created but haven't started yet.</p><p>• <strong>Active Promo Codes</strong> (Default): Promo codes that are currently <em>Active</em>.</p><p>• <strong>Expired Promo Codes</strong>: Promo codes which were previously <em>Active</em> and have now <em>Expired</em></p></td></tr><tr><td>Deal</td><td>Select <a href="/brand/what-would-you-like-to-learn-about/platform-features/deals.md"><strong>Deal</strong></a> to filter promo codes by a specific deal.</td></tr><tr><td>Country</td><td>Select <strong>Country</strong> to filter for promo codes restricted to one or more countries. You can search the list and select more than one country. Promo codes that aren't restricted to any countries don't appear in the results.</td></tr></tbody></table>

</details>

<details>

<summary>More actions reference</summary>

<table><thead><tr><th width="180.296875">Status</th><th>Use case</th></tr></thead><tbody><tr><td>Expire</td><td>Used to expire an <em>Active</em> promo code.</td></tr><tr><td>Reactivate</td><td>Used to activate an <em>Expired</em> promo code.</td></tr><tr><td>Download</td><td>Used to generate a CSV file with details about the selected promo codes, including the code, description, dates, usage limits, status, and discount type, for all promo codes in any status.</td></tr><tr><td>Change active dates</td><td><p>Used to change the dates a promo code is set to be active. Choose the new active and expiration dates, then select <strong>OK</strong> to confirm.</p><p><strong>Note:</strong> Depending on the new dates, the promo code's status may change: <em>Active → Pending</em> if the new dates are in the future, <em>Pending → Active</em> if the dates overlap with today, or <em>Expired → Pending</em> if the new dates are in the future.</p></td></tr></tbody></table>

</details>

<details>

<summary>Columns reference</summary>

<table><thead><tr><th width="180.32421875">Column</th><th>Description</th></tr></thead><tbody><tr><td>Promo Code</td><td>The name of the promo code.</td></tr><tr><td>Media</td><td>The media source for the promo code.</td></tr><tr><td>Deal</td><td>The <a href="/brand/what-would-you-like-to-learn-about/platform-features/deals/deal-types-overview.md">deal type</a> associated with the promo code.</td></tr><tr><td>Max Usage</td><td><p>The maximum number of times the promo code can be used. If no limit is set, this column shows <em>Unlimited</em>.</p><p><em>Unlimited Per Customer</em> appears below the value if that option was selected when the promo code was created or edited.</p></td></tr><tr><td>Countries</td><td><p>The countries where the promo code is valid, if restricted. The column shows the first 2 countries, followed by <em>+X</em> if there are more. Hover over <em>+X</em> to see the remaining countries.</p><p>If the promo code isn't restricted to any countries, the column shows a dash (-).</p></td></tr><tr><td>Match Mode</td><td><p>• <strong>Exact Match</strong>: The promo code matches exactly, no variations allowed for the partner to get credit.</p><p>• <strong>Regex Match</strong>: Patterns were used to match the promo code, allowing for more flexibility in what counted as a match.</p></td></tr><tr><td>Credit Rule</td><td><p>• <strong>Always Credit</strong>: Promo code always gets credit.</p><p>• <strong>Credit If Involved</strong>: Promo code only gets credit if the partner drove clicks.</p><p>• <strong>Credit If Winner</strong>: Promo code only gets credit if the partner drove the winning click.</p></td></tr><tr><td>Status</td><td>The current status of the promo code.</td></tr><tr><td>Date Assigned</td><td>The date the promo code was created.</td></tr><tr><td>Scheduled Dates</td><td>The dates the promo code is set to <em>Activate</em> and <em>Expire</em>.</td></tr></tbody></table>

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/promo-codes/manage-your-promo-codes.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
