> For the complete documentation index, see [llms.txt](https://docs.shoffi.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shoffi.app/for-app-owners/the-affiliate-terms.md).

# The affiliate terms

The affiliate terms are the default contract between an app and an affiliate.\
Once an affiliate makes a new referral, commissions are based on those terms.

You can always change the app's default terms or [change them for an individual affiliate](#editing-the-affiliate-terms).

## Terms breakdown

* **Commission Rate**:

  The percentage you are willing to pay an affiliate for every transaction made by a store they referred. You can read more about [the affiliate commission](/general/the-affiliate-commission.md).
* **Commission Rate Period Limit:**\
  The number of months an affiliate earns commissions from transactions made by the referred store. If there is no limit, the affiliate earns commissions while the referral is active.
* **CPI:**

  Cost per install. The amount an affiliate is rewarded for each successful app install. You can set the amount to `0` if you do not want to pay per install. For post-install matches, CPI is charged on the next nightly update that includes that shop from Shopify. If Shopify never reports the shop, CPI is not charged. Owner-approved manual referrals are charged when you approve them.
* **Minimum Withdrawal:**

  The minimum amount an affiliate must earn before they can request a withdrawal. This amount is in USD.
* **Auto Approval:**

  If enabled, every affiliate who joins your affiliate program is approved automatically — including market requests and affiliates who use a group invite link. If disabled, you must approve each request manually on the `Affiliates` page, no matter how the affiliate applied.
* **Recurring charges only:**\
  If enabled, affiliates receive a share of revenue only from recurring payments, not from one-time fees.
* **Require invoice:**\
  If enabled, affiliates must attach an invoice to every payout request for this app before they can submit it — either upload a PDF (up to 2MB) or paste an `https://` link. You can review that invoice from payment details on the `Payouts` page before paying.
* **Disable manual referrals:**\
  If enabled, affiliates cannot submit manual referrals for this program. You can still add referrals yourself from the affiliate connection page, and the Shoffi API `addReferral` endpoint still works.
* **Custom Terms And Conditions (optional):**\
  A link to a webpage with your own affiliate program terms. When set, affiliates see and must acknowledge that link when joining.

## Advanced Terms

On the app page, **Disable manual referrals**, **Require invoice**, and **Custom Terms And Conditions** live under **Advanced Terms**, which is collapsed by default. When you edit a group or a single affiliate’s terms, Advanced Terms shows **Disable manual referrals** only (Require invoice and custom terms stay app-wide).

Changing only these Advanced Terms settings does not send a terms-changed notification or email to affiliates. Affiliates are notified when you change commission terms such as rate, period, CPI, or minimum withdrawal.

## Editing the affiliate terms

You can edit your app's main affiliate terms when [editing your app](/for-app-owners/managing-your-apps.md).

You can also change terms for a specific affiliate by [editing affiliate terms](/for-app-owners/managing-affiliates.md#editing-affiliate-terms).
