> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.promoparty.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Setting Up Promo Party Pro

# Complete Walkthrough

**Summary:** Step-by-step guide to installing Promo Party Pro and creating your first gift-with-purchase campaign.

${youtube}[Walkthrough: Set up your first campaign](lB4Win7ZwsY)

---

## Install the App

1. Search for **Promo Party Pro** in the Shopify App Store
2. Click **Install** from the app listing
3. Select a plan (free trial available for new installs)

After you pick a plan, the app walks you through two setup steps: enabling the theme extension, then creating your first campaign.

---

## Enable the Theme Embed

Promo Party Pro uses a theme app extension to show the gift pop-up and add gifts on your storefront. It takes about 30 seconds.

1. Click **Go to theme settings** in the app. Your theme editor opens on the **App embeds** panel.
2. Find the Promo Party Pro embed and toggle it on
3. Click **Save**
4. Come back to the app

The app detects the embed automatically and moves you to the next step.

**If you need to do it manually:**

1. Go to **Online Store > Themes** in your Shopify admin
2. Click **Customize** on your live theme
3. Click **App embeds** in the left sidebar
4. Toggle the Promo Party Pro embed on
5. Click **Save**

The embed must be on in your **live** theme. If you switch themes later, turn it on in the new theme too. The app shows a banner if the embed is missing.

---

## Create Your First Campaign

Go to **Campaigns** and create a new campaign. Every setting can be changed later.

### Campaign Details

Give your campaign a **Title**. This is for your reference. Customers won't see it. The app suggests a title as you pick a trigger and gift.

### Choose a Trigger

The trigger decides when a customer qualifies for the free gift. Pick one:

**Cart total reaches a certain amount**
The cart must reach your **Minimum cart price** (for example, $50). Free gifts already in the cart don't count toward the total. Shoppers paying in another currency are converted automatically.

**Specific product is in the cart**
The customer must have one of the products (and variants) you pick in their cart.

**Product is in a specific collection**
The customer must have any product from one of the collections you pick. Shopify allows up to 100 collections in total across all your campaigns.

### Select Your Free Gift

In the **Free Gift** section, choose what customers receive.

* **Single variant**: one specific item (for example, "Black Tote Bag")
* **Multiple variants**: one product with options (for example, "Tote Bag" in Black, Navy, or Natural)
* **Multiple products**: a selection of different items to choose from

Each campaign adds **one** gift per order. To give two gifts, or different gifts at different spend levels, see [Offering more than one free gift or tiered gifts](https://help.promoparty.app/en/article/offering-more-than-one-free-gift-or-tiered-gifts-qowwgt/).

**Your gift product must:**

* Be **Active** or **Unlisted** (not Draft or Archived)
* Be published to the **Online Store** sales channel
* Have a price above $0. Keep the normal price. The app's discount makes it free when the customer qualifies, and a real price stops customers from adding it on their own.
* Be in stock, or set to keep selling when out of stock

The campaign page shows a warning banner if any of these is off.

### Set the Schedule

* **Start now**, or **Schedule for later** with a start date and time
* **+ Set end date** to end the campaign automatically (optional)

Dates and times use your store's time zone, shown next to each field.

**Tip:** if you run several campaigns, give each one an end date. A date far in the future is fine. See [Quick Troubleshooting Guide](https://help.promoparty.app/en/article/quick-troubleshooting-guide-1vuw2jn/) for why.

### Configure the Pop-up

In **Pop-up Settings**, check **Show Pop-up for gift selection** to let customers choose their gift.

**When you need it:**

* Gift has size or color variants
* You offer more than one gift product

**When you don't:**

* Single item, no variants
* The gift can be added without customer input. With the pop-up off, the app adds the first available gift option automatically.

**Pop-up options:**

* **Re-display pop-up after dismissal**: if a customer closes the pop-up or clicks **Skip gift**, how long to wait before offering it again (**Always**, or after 2, 5, 10, 15, or 30 minutes)
* **Text**: the pop-up title, description, and button are edited per language on the **Translations** page
* **Styling**: colors, corners, and borders are set in **Settings**

See [Customizing the gift popup](https://help.promoparty.app/en/article/customizing-the-gift-popup-alhzsl/) for details.

### Set Discount Combinations

This is the most important setting.

Promo Party Pro uses an automatic discount in Shopify to make the gift free. If you want it to work alongside other discounts (like a welcome code or free shipping), you need to allow combinations.

**In Promo Party Pro:**
Under **Discount Combinations**, check **Combine with order discounts**, **Combine with product discounts**, and/or **Combine with shipping discounts**. All three are off by default.

**In Shopify:**
Your other discounts must also be set to combine with product discounts. Both sides need to allow it.

**What happens if you skip this:**
If a customer applies a discount code that doesn't combine, Shopify may apply that code instead of the free gift discount, and the customer is charged for the gift.

See [How different discounts combine](https://help.promoparty.app/en/article/how-different-discounts-combine-173dh7z/) for details.

---

## Save and Review

Click **Save** in the save bar at the top.

The **Summary** card on the right sums up your campaign in one sentence, and the **Pop-up Preview** shows roughly what customers will see. The preview uses sample content, so check your live store too.

---

## Test It

Click **Test on storefront** in the campaign's **Status** card to open your store. Add items until you qualify and confirm the gift appears and is free at checkout.

See [Testing your promotion](https://help.promoparty.app/en/article/testing-your-promotion-1lv4da8/) for a full checklist.

---

## Monitor Your Campaigns

The **Campaigns** list shows each campaign's status:

* **Draft**: not set to run yet
* **Scheduled**: will start at its start date
* **Running**: live now
* **Paused**: stopped by you
* **Ended**: past its end date

Use **Pause**, **Resume**, or **Start Now** to change a campaign's status. Use **Duplicate** to copy a campaign.

**Proactive warnings:**
If something goes wrong during a live campaign (for example, the gift goes out of stock, or a product is set to Draft or removed from the Online Store), a warning appears on the campaign and on your dashboard. You don't have to discover problems yourself.

---

## Next Steps

* [Testing your promotion](https://help.promoparty.app/en/article/testing-your-promotion-1lv4da8/): verify everything works before going live
* [How different discounts combine](https://help.promoparty.app/en/article/how-different-discounts-combine-173dh7z/): a deep dive on discount stacking
* [What happens when gifts sell out](https://help.promoparty.app/en/article/what-happens-when-gifts-sell-out-lfpust/): automatic behavior and recovery
* [How to add the Product Page CTA Block](https://help.promoparty.app/en/article/how-to-add-the-product-page-cta-block-14cgx7s/): show shoppers how close they are to a gift

---

## Need Help?

Open the Promo Party Pro app in your Shopify admin and click the chat icon. We're real people and we respond fast.