---
title: Shopify Cart Permalinks Explained: Format, Discounts and Limits | Cart Rocket Blog
description: How Shopify cart permalinks work: the /cart/variant:quantity format, several products, going straight to checkout, discount codes, prefilled checkout fields and what they can't do.
url: https://cartrocket.dev/blog/shopify-cart-permalinks-explained.html
---

How-to · 6 min read · By Robin · November 18, 2026

# Shopify Cart Permalinks Explained: Format, Discounts and Limits

Every Shopify store can already build a link that fills the cart and opens checkout. This is the URL format, the parameters Shopify documents, and the jobs a permalink can't do.

AI-generated illustration with sample data. Not a real product image.

**Short answer:** a Shopify cart permalink is a URL in the form `your-store.myshopify.com/cart/VARIANT_ID:QUANTITY`. Separate several `variant:quantity` pairs with commas to add more than one product. It opens checkout by default. Add `storefront=true` to land on the cart page instead, `payment=shop_pay` for Shop Pay, `discount=CODE` to apply a code that already exists, and `checkout[email]` or shipping address fields to fill in checkout. It can't count opens and orders per link, start or stop on a date, change after you've shared it, or sell a bundle at one price.

Everything about permalinks below comes from Shopify's developer docs and Help Center, read on November 18, 2026. We make Cart Rocket, which comes up near the end.

## The basic format

A permalink puts a variant ID and a quantity after `/cart/`. This is the example from Shopify's [Help Center](https://help.shopify.com/en/manual/products/details/checkout-link):

```
https://my-shop-name.myshopify.com/cart/36485954240671:1
```

The number has to be the variant ID, and every size or colour has its own. To find one, go to **Products** in your admin, open the product, click the variant in the **Variants** section and look at the address bar. The number after `/variants/` is the one you want. The same address also holds the product's ID, so check you copied the right number.

If you have the Buy Button channel installed, there's a shortcut. On a product page, click **More actions**, then **Create checkout link**, pick a variant and copy the link. You get one variant at a quantity of 1. Anything more, you type by hand.

## Several products in one link

List each `variant_id:quantity` pair and separate them with commas. Shopify's [developer docs](https://shopify.dev/docs/apps/build/checkout/create-cart-permalinks) use this one:

```
https://{shop}.myshopify.com/cart/70881412:1,70881382:1
```

Change the number after the colon to set the quantity. Neither Shopify page says whether the link replaces what's already in the shopper's cart or adds to it, so before you send one out, open it in a browser that already has something in the cart and see what happens.

## Straight to checkout, the cart or Shop Pay

A permalink opens checkout unless you tell it otherwise. If you were looking for a way to skip the cart page, this is it: the shopper lands on checkout with the items already there. Two parameters change where they land:

- `?storefront=true` sends them to your online store's cart page.
- `?payment=shop_pay` sends them to a Shop Pay checkout.

The first parameter starts with `?` and each one after it starts with `&`.

## Attaching a discount code

Add `discount=` with a code you've already created in Shopify. For two or more codes, separate them with commas:

```
https://{shop}.myshopify.com/cart/70881412:1,70881382:1?discount=SAVE10,FREESHIP
```

A code with a comma in it can't be passed this way, so keep campaign codes simple. The link only enters the code for the shopper. The code's own settings in Shopify still decide whether it applies, so an ended code, or two codes that aren't allowed to combine, fail the same way they would if the shopper typed them. Our post on [discount links that don't apply](https://cartrocket.dev/blog/shopify-discount-link-not-applying.html) goes through the usual causes.

## Prefilling checkout fields

Permalinks accept `checkout[email]` and these shipping address fields: `first_name`, `last_name`, `address1`, `address2`, `city`, `province`, `country` and `zip`, each written like `checkout[shipping_address][city]`. Phone isn't on Shopify's list.

A link with someone's email in it belongs in a message to that one person. If you want to fill these in from Klaviyo or another email or SMS tool, our guide to [prefilling checkout from merge tags](https://cartrocket.dev/blog/prefill-shopify-checkout-email-sms.html) covers the tags, the link format and the privacy side, so I won't repeat it here.

## Notes, attributes and referral codes

For tracking, Shopify documents three parameters. `note` and `attributes[name]` show up in the Notes section of the order. `ref` shows up as a referral code in the order's Conversion summary. Sales channel apps can also add a storefront `access_token` so orders appear under their channel. You read all of it order by order.

## Shopify now calls these legacy

Shopify's developer docs label `/cart/` permalinks a legacy feature and point to a successor called [Cart and Checkout Permalinks](https://shopify.dev/docs/agents/carts-and-checkout/permalinks), written mostly for AI agents and apps that hand a shopper a ready cart. The same docs say to keep using the legacy format if you need a cart note, cart attributes, line item properties or a `ref` code. Neither version supports selling plans, so subscription products are out either way. Neither page I read says when, or whether, the `/cart/` format will stop working.

## What native permalinks can't do

Permalinks are free, and they're fine for one simple offer you build once. These are the jobs they don't cover:

- Tracking. There's no count of opens, checkouts, orders or revenue per link. You get notes and a `ref` code on each order.
- Scheduling. A permalink works from the moment it exists, so it goes live when you send it.
- Expiry. The link has no end date of its own. You can put an end date on the discount code, but that ends the discount, and the link still fills the cart.
- Editing a live link. The URL is the cart. Swap a product or fix a variant and you have a new URL, while the old one stays in every email, ad and printed QR code that already carries it.
- Bundles. You can list several products and add a code, but you can't sell them as one cart line at one price.
- Subscriptions. Shopify's docs say selling plans don't work with cart permalinks.
- Keeping the cart fixed. The variant IDs and quantities sit in the URL for anyone to change, and Shopify documents nothing that stops a shopper changing the cart once it's loaded.

## What Cart Rocket adds

Cart Rocket links live on your own domain at a readable address such as `your-store.com/apps/cart/summer-kit`. The products and discounts are saved in the app and the cart is built on the server, so editing the address changes nothing. When you edit the cart, the link you already shared picks up the change.

On top of that you get line-item, cart-wide and shipping discounts without a code (codes still work if you want them), bundles sold at one price, subscription products, start and end dates in your store's time zone, customer rules and purchase limits. When an offer is over, shoppers land on the product or home page with a short notice. Analytics shows orders, revenue and average order value per link, with a checkout funnel from link opened to checkout completed, and creator links tag each order with the creator's code. If the offer price only works for an exact set of products, [Lock offer cart](https://cartrocket.dev/blog/lock-offer-cart-shopify.html) stops shoppers paying for a changed cart.

For a row-by-row comparison, read [Shopify cart permalinks vs Cart Rocket](https://cartrocket.dev/compare/shopify-cart-permalinks-vs-cart-rocket.html). If you're weighing other apps too, the [Shopify cart link apps comparison](https://cartrocket.dev/compare/shopify-cart-link-apps.html) lists what each one does.

## FAQ

### What is a cart permalink in Shopify?

A cart permalink is a URL that fills a shopper's cart with set variants and quantities and opens checkout. It looks like your-store.myshopify.com/cart/VARIANT_ID:QUANTITY. Every Shopify store has them, and they're free.

### How do I add multiple products to a Shopify cart permalink?

Separate each variant_id:quantity pair with a comma, for example /cart/70881412:1,70881382:2. Each number before the colon must be a variant ID, which you find in the address bar when you open the variant in your admin.

### Can a cart permalink skip the cart and go straight to checkout?

Yes. Checkout is the default, so the shopper never sees the cart page. Add storefront=true to send them to the cart page instead, or payment=shop_pay for a Shop Pay checkout.

### How do I add a discount code to a Shopify cart permalink?

Add ?discount=CODE to the link, or &discount=CODE if it already has a parameter. Separate several codes with commas. The code must already exist in Shopify, and a code that contains a comma can't be passed this way.

### Do Shopify cart permalinks expire?

No. A permalink has no start or end date. You can set an end date on the discount code, which ends the discount but not the link. Cart Rocket links can have start and end dates in your store's time zone.

### Do cart permalinks work with subscription products?

No. Shopify's developer docs say selling plans don't work with cart permalinks, and the newer Cart and Checkout Permalinks add every item as a one-time purchase. Cart Rocket links can add subscription products on a plan.
