Skip to main content
You can construct a URL that fills a customer’s basket with products when they open your store. The link replaces anything already in that customer’s basket. This is useful for marketing campaigns, QR codes, re-order links, or any scenario where you want to send a customer directly to checkout with specific items.
A basket prefill link adds products to the basket; it does not open a product’s details. To send customers from an ad to a category or a search of your menu instead, see Linking to Your Menu from Ads and Social.

URL Format

The {products} parameter is a comma-separated list of items, where each item follows the format:

Example

To add 2 units of product BURGER01 and 1 unit of product FRIES01:

Modifiers

A product can carry a modifier selection in parentheses, immediately after its quantity. Modifiers are separated by semicolons:
If the same modifier PLU exists in more than one modifier group on the product, it resolves to the first group that carries it, in the order the groups appear on the product. Top-level groups are checked before nested groups.

Example

To add 2 burgers with cheese (×1) and bacon (×1):
Products with required modifier groups (for example “Choose a size”) can now be prefilled, provided the URL satisfies every required group:
The same product with different modifier selections creates separate basket lines. The same product with an identical selection is merged into one line with the quantities added together. Tracked inventory is allocated to lines in the order they appear in the URL: each line either fits within the stock left for its product and modifiers, or is skipped. Nested modifier groups can be prefilled, provided the parent option that opens them is in the URL or selected by default, and each nested choice’s PLU resolves to its own group (a PLU shared with a top-level option resolves to the top-level group, as above).

How It Works

  1. The customer opens the URL.
  2. The store loads the menu as usual.
  3. Each PLU in the URL is matched against available products.
  4. Valid items are added to the basket with the specified quantities.
  5. The customer is redirected to the menu page with the basket pre-populated and can proceed to checkout.

Validation Rules

Each item in the URL is validated individually. Items that fail validation are skipped, and the remaining valid items are still added to the basket. The customer will see a notification listing any items that could not be added.
Modifier groups with default selections are applied automatically when the URL does not mention that group.

Query Parameters

You can combine the basket URL with the customer detail prefill parameters your store supports, so the checkout form arrives already filled in:
There is no discount-code query parameter. Discount codes are applied by a separate link, /{venueSlug}/menu/discount/{code}, which cannot be combined with a basket prefill URL.

Finding PLU Codes

PLU codes are configured per product in the storekit dashboard under your menu settings. They are the same codes used for POS integrations. See PLU Mapping for more details on managing PLU codes.