Skip to main content

Documentation Index

Fetch the complete documentation index at: https://storekit.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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

https://{your-store-domain}/{venueSlug}?firstName={value}&lastName={value}&email={value}&phone={value}&postCode={value}
All parameters are optional — include only the ones you want to prefill.

Supported Parameters

ParameterDescriptionExample
firstNameCustomer’s first namefirstName=Jane
lastNameCustomer’s last namelastName=Smith
emailCustomer’s email addressemail=jane@example.com
phoneCustomer’s phone numberphone=%2B447700900000
postCodeDelivery postcodepostCode=SW1A%201AA
Values containing special characters must be URL-encoded. For example, +447700900000 becomes %2B447700900000, and spaces become %20.

Examples

Prefill just an email address:
https://order.storekit.com/my-restaurant?email=jane@example.com
Prefill full customer details:
https://order.storekit.com/my-restaurant?firstName=Jane&lastName=Smith&email=jane@example.com&phone=%2B447700900000
Combine with a discount code:
https://order.storekit.com/my-restaurant?email=jane@example.com&discount=WELCOME10

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 query parameters are removed from the URL so they do not appear in the address bar or get shared accidentally.
  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:
https://order.storekit.com/my-restaurant/basket/BURGER01:2,FRIES01:1?firstName=Jane&email=jane@example.com

Field Visibility

Prefilled values only appear if the corresponding field is enabled in your store’s User Information Settings in the dashboard. 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 query 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 fields remain populated for the duration of the session.