Documentation

Setup & testing guide

Everything needed to install, configure and verify Persistent Cart. The core feature (cross-device cart persistence) works on the Free plan, with no payment required to test it.

01 — Before you start

Requirements

Platform limit

Guest (not-logged-in) carts are stored locally on the device and cannot sync across devices. This is a Shopify constraint, not an app limitation — cross-device restore requires a registered, logged-in customer.

02 — Two minutes

Installation

Persistent Cart activates from your Shopify Admin. No code, no developer. Two steps: install the app, then enable its Theme App Embed.

  1. Install the app from the Shopify App Store listing and approve the requested access. You land in the embedded admin dashboard. The default plan is Free.
  2. Enable the Theme App Embed (required). Go to Online Store → Themes → Customize → App embeds, toggle on “Persistent Cart”, then Save.
  3. Done. Carts now persist for logged-in customers, and the “Share this Cart” button appears on the cart. Setup takes under 60 seconds.
This step is mandatory

Without the App embed enabled, no functionality runs — no persistence, no share button. If something isn't working, check the embed toggle first.

Get started

You choose a plan on Shopify's plan page when you first open the app. The Free plan needs no payment.

  1. Go to Online Store, then Edit theme, then App embeds.
  2. Turn on "Persistent cart" in the App embeds list.
  3. Click Save.

Once saved: logged-in customers keep their cart across devices, and a "Share this Cart" button appears on the cart.

Shipping calculator (optional)

The cart can show a shipping estimate before checkout. It is a separate block, so it appears only where you place it.

  1. Go to Online Store, then Edit theme, then open the Cart template.
  2. If the Cart template has no Apps section, click Add section and choose Apps.
  3. In the Apps section, click Add block and choose "Shipping calculator".
  4. Click Save.

The estimate uses your store's own shipping rates, for the cart the customer is looking at. It needs a Shopify-hosted theme: on a custom storefront the block does not appear.

Not working? Check these in order:
  1. Is the App embed turned on? Without it, nothing runs: no cart persistence, no share button.
  2. Is the customer logged in? The app saves and syncs carts for logged-in customers only. A guest's cart is Shopify's own browser cart, so it stays on that device.

03 — Optional

Configuration

Defaults work out of the box. To customize, open the app's Settings page in the embedded admin. Settings are saved to your shop and read by the storefront automatically.

SettingWhat it doesPlan
Cart conflict modalWhen a shared cart meets an existing cart, show a Merge / Replace / Cancel dialog instead of auto-merging.All plans
Share cart iconShow the share button and pick its style (link / share / cart icon).Pro+
Redirect to checkoutSend the customer straight to checkout after a cart is restored.Paid
Cart expiryHow long an inactive saved cart is kept (7 / 14 / 30 / 60 days). Free is fixed at 2 days.Paid
Custom CSS classesHook the share button and conflict modal into your theme styles.Pro+

04 — Verify it works

Testing

Cross-device persistence

  1. Log in as a customer on the storefront and add a few products to the cart.
  2. Open the store on a second device or browser, logged in as the same customer, with an empty cart.
  3. Load any page. The saved cart is restored automatically and the page reloads with the items back.

Share this Cart

  1. On the cart page or cart drawer, click “Share this Cart” (next to Checkout). A short link is copied to the clipboard.
  2. Open that link in another browser. A “Merging your cart…” overlay appears and the items are added.
  3. If you already had items and the conflict modal is on, the Merge / Replace / Cancel dialog appears.

05 — Compliance

Data & privacy