Skip to main content
You can construct a URL that automatically fills in a customer’s contact details (name, email, phone, etc.) when they open your store. This is useful for marketing campaigns, loyalty program links, captive Wi-Fi portals, QR codes, or any integration where you already know the customer and want to save them from entering their details manually.

URL Format

All parameters are optional — include only the ones you want to prefill.

Supported Parameters

Values containing special characters must be URL-encoded. For example, +447700900000 becomes %2B447700900000, and spaces become %20.

Examples

Prefill just an email address:
Prefill full customer details:
To apply a discount code, use a discount link instead — the code travels in the path, not the query string:
Discount links cannot be combined with customer detail parameters: opening a discount link redirects to the menu and drops any query parameters on the way.

How It Works

  1. The customer opens the URL containing query parameters.
  2. The store loads the menu as usual.
  3. Each recognised parameter is read and used to populate the corresponding field in the checkout form.
  4. The recognised prefill parameters are removed from the URL so they do not appear in the address bar or get shared accidentally. Any other parameters (such as utm_* tags) are left in place.
  5. The customer sees their details pre-filled at checkout and can review or edit them before placing an order.

Combining with Basket Prefill

You can combine customer detail parameters with a basket prefill URL to send a customer directly to a pre-populated basket with their details already filled in:

Field Visibility

Prefilled values only appear if the corresponding field is turned on for your store. Field settings are on the Checkout fields card under Stores → your store → Settings → Operations, with Custom checkout fields turned on. For example, if the phone number field is disabled for your store, the phone parameter will be accepted but won’t be visible to the customer at checkout.
The recognised prefill parameters are removed from the URL after being applied. If the customer refreshes the page, the values will not be re-applied from the URL. However, the name, email and phone values are saved in the customer’s browser, so they stay filled in on later visits until the customer changes them.