# Shopify

Plandalf does not replace Shopify’s store engine. Use it when a campaign, service, add-on, booking, digital product, or paid upgrade should run through a Plandalf offer instead of the native Shopify cart.

> [!NOTE]
> **Keep the store and the offer separate**
> Shopify owns the catalog and cart. Plandalf owns the focused offer flow, checkout blocks, deadline context, order bumps, invoices, and follow-up automation.

## The path

1.  Choose the offer that sits beside Shopify

    Pick the upsell, booking, service, event, digital product, or campaign checkout that should use Plandalf.

2.  Load the SDK in the theme

    Add the organization SDK before the closing `body` tag in the theme or through a managed script area.

3.  Add a Plandalf button to the right template

    Use `data-plandalf-present` on a product template, landing page, blog post, or campaign section.

4.  Test checkout and fulfillment separately

    Confirm the Shopify path still works, then complete the Plandalf offer in test mode.

## Common patterns

- [VIP upgrade](https://plandalf.com/docs/product-guides/checkouts/order-bumps) — Sell a paid upgrade beside a Shopify product launch.

- [Campaign checkout](https://plandalf.com/docs/product-guides/checkouts/buy-buttons) — Send ad or email traffic to a focused offer outside the normal cart.

- [Deadline promo](https://plandalf.com/docs/product-guides/promos/overview) — Pair a timer and promo price with a Plandalf checkout.

- [Service or booking](https://plandalf.com/products/checkouts) — Sell something adjacent to the product catalog without changing Shopify checkout.

## Theme snippet

<scalar-tabs default="Script">
<scalar-tab title="Script">

```html
<script src="https://acme.plandalf.dev/js/plandalf-sdk.js" async></script>
```

</scalar-tab>
<scalar-tab title="Button">

```html
<button data-plandalf-present="vip-upgrade">
  Add VIP upgrade
</button>
```

</scalar-tab>
<scalar-tab title="Promo button">

```html
<button
  data-plandalf-present="vip-upgrade"
  data-plandalf-apply-promo="launch-week"
  data-plandalf-mode="test"
>
  Claim launch price
</button>
```

</scalar-tab>
</scalar-tabs>

> [!WARNING]
> **Do not mix carts accidentally**
> If a buyer should complete the Shopify cart and a Plandalf offer, make the handoff explicit in the page copy and fulfillment workflow. Do not hide a second checkout behind a normal add-to-cart action.

## Related docs

- [Buy buttons](https://plandalf.com/docs/product-guides/checkouts/buy-buttons) — Open a Plandalf offer from Shopify content or theme templates.

- [Timers overview](https://plandalf.com/docs/product-guides/promos/overview) — Connect deadline promos to offer pricing and checkout behavior.

- [Stripe setup](https://plandalf.com/docs/product-guides/platforms/stripe) — Route Plandalf offer payments through your connected processor.

Source: https://plandalf.com/docs/product-guides/platforms/shopify