URL Format
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: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
- The customer opens the URL containing query parameters.
- The store loads the menu as usual.
- Each recognised parameter is read and used to populate the corresponding field in the checkout form.
- 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. - 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, thephone parameter will be accepted but won’t be visible to the customer at checkout.