Skip to main content
You can construct a URL that automatically adds products to a customer’s basket when they open your store. 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.

​
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.

​
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. Modifier groups that are nested inside another modifier option cannot be prefilled.

​
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 any standard query parameters your store supports. For example, to also apply a discount code:

​
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.

Related topics

Customer Details Prefill via URLWebMCP ToolsMCP EndpointZonal (Aztec)Stories Strategy & Best Practices