# Subscription integration

## Overview

The **Purchase Type** setting lets you control whether a Buy X Get Y (BXGY) campaign applies to one-time purchases, subscription purchases, or both. This gives you precise control over how gifts are rewarded based on how customers buy your products.

***

## Where to Find It

{% stepper %}
{% step %}
Go to **Gift Campaigns** in the app
{% endstep %}

{% step %}
Open an existing **Buy X Get Y** campaign or create a new one
{% endstep %}

{% step %}
In the **Customer Buys** section, find the **Purchase Type** dropdown
{% endstep %}
{% endstepper %}

***

## Purchase Type Options

<figure><img src="https://1289686769-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMo81Ak7Ig0Z6bLRmWpSA%2Fuploads%2FIvuzbkYdIeArSmDlgrpn%2FUntitled_card.png?alt=media&#x26;token=fb102323-9cc2-4c41-ac34-b7b885bee083" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="220">Option</th><th>Description</th></tr></thead><tbody><tr><td><strong>One-time purchase</strong> <em>(default)</em></td><td>Campaign applies only when the trigger product is purchased as a regular, one-time order</td></tr><tr><td><strong>Subscription</strong></td><td>Campaign applies only when the trigger product is purchased via a subscription plan</td></tr><tr><td><strong>Both</strong></td><td>Campaign applies regardless of purchase type</td></tr></tbody></table>

***

## How Each Option Works

### One-time Purchase (Default)

The gift is added when the customer adds the trigger product to cart **without** a subscription plan attached.

**Behavior:**

* Gift is added for regular one-time purchases
* Gift is **not** added if the trigger product is purchased as a subscription

{% hint style="info" %}
All BXGY campaigns created before this feature was introduced automatically default to **One-time purchase**. No action is required — these campaigns continue to work exactly as before.
{% endhint %}

{% hint style="warning" %}
If your trigger product is sold as a **subscription only** (not available as a one-time purchase), a yellow warning badge will appear in the campaign editor to alert you of the mismatch.
{% endhint %}

***

### Subscription

The gift is added when the customer purchases the trigger product **with a subscription plan**.

**Behavior:**

* Gift is added on the **first order** of the subscription only
* Recurring subscription orders do **not** receive the gift again
* Gift is **not** added for regular one-time purchases

**Compatible subscription apps:**

* Shopify native subscriptions
* Recharge
* Appstle
* Seal Subscriptions
* Joy Subscription

{% hint style="warning" %}
If your trigger product is a **regular (non-subscription) product**, a yellow warning badge will appear in the campaign editor to alert you of the mismatch.
{% endhint %}

***

### Both

The gift is added for all customers — whether they buy one-time or via subscription.

**Behavior:**

* Gift is added for regular one-time purchases
* Gift is added on the **first subscription order** only
* Recurring subscription orders do **not** receive the gift again

***

## Warning Badges

The system displays warning badges in the campaign editor to help you catch configuration mismatches before publishing.

<table><thead><tr><th width="420">Situation</th><th>Badge</th></tr></thead><tbody><tr><td>Trigger product is subscription-only, but Purchase Type = <strong>One-time purchase</strong></td><td>⚠️ "Subscription product"</td></tr><tr><td>Trigger product is a regular product (not subscription), but Purchase Type = <strong>Subscription</strong></td><td>⚠️ "One-time product"</td></tr></tbody></table>

<figure><img src="https://1289686769-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMo81Ak7Ig0Z6bLRmWpSA%2Fuploads%2FsI4hR7NaFzHZifbDOW2P%2Fscreenshot1_card.png?alt=media&#x26;token=30e60936-fdf4-4483-99bd-0da5a94ccd29" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1289686769-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMo81Ak7Ig0Z6bLRmWpSA%2Fuploads%2FmbGoQv5gDJCjoDsdvN7Y%2Fscreenshot2_card.png?alt=media&#x26;token=4f9ace61-cd00-4669-8607-140ca2cee75a" alt=""><figcaption></figcaption></figure>

***

## Stores Without Subscription Products

If your store has no subscription products, the **Subscription** and **Both** options will be **disabled** in the Purchase Type dropdown.

Hovering over the disabled options will show a tooltip:

> *"No subscription products found in your store"*

To enable these options, set up subscription products using a compatible subscription app.


---

# 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.aov.ai/advanced-settings/subscription-integration.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.