Query parameters allow you to customize public links in Waitwhile by pre-filling information, filtering data, or enhancing user experience. By adding query parameters to your URLs, you can streamline customer interactions and improve efficiency.
Understanding Query Parameters
A query parameter is a piece of information appended to the end of a URL that allows you to pass specific data into a web form—such as a customer’s name, email, phone number, or selected service.
In Waitwhile, you can use query parameters to pre-fill registration form fields on booking or waitlist pages, streamlining the customer or staff experience by reducing the need for manual entry.
For example:
https://waitwhile.com/locations/revival?name=John%20Doe&phone=4043239983&email=johndoe@waitwhile.com
In this example, the additional information: name, phone, and email are automatically passed through into the registration form so that the customer does not have to manually enter it to complete the registration process.
Commonly used query parameters
1. To pre-fill customer information
By passing key details—such as the customer’s name, phone number, email, or service—directly through the URL, the form fields are prefilled when the page loads. This helps eliminate manual data entry for staff or customers, ensures greater accuracy, and speeds up the registration or check-in process.
Pre-fill guest full name →
?name=John%20DoePre-fill guest first name →
?firstname=JohnPre-fill guest last name →
?lastname=DoePre-fill guest phone →
?phone=8881234567Pre-fill guest email →
?email=john@doe.comPre-fill guest Customer ID →
?externalcustomerid=abc123Pre-fill guest party size and SKIP this step in flow →
?partysize=10Set the language to e.g. French →
?locale=fr-FRRedirect the customer to any website →
?redirect_url=yourwebsite.comPre-fill visit as a booking or waitlist visits →
?registration=waitlistand?registration=booking
Example:
https://waitwhile.com/locations/revival?name=John%20Doe&phone=4043239983&email=johndoe@waitwhile.com
2. To Pre-Select Services and Resources
Similarly to pre-filling customer information, you can also use query parameters to pre-select services or resources. These query parameter utilizes the individual Service ID and Resource ID.
Pre-select Services →
service=ServiceIDPre-select Resources →
resource=resourceID
Example:
https://waitwhile.com/locations/revival?service=ngxV6j4EGk1uqkfu2C9v&resource=D86FM1l2nTinzzu3E2hW
Learn more about Using query parameters to pre-select Services & Resources
3. To filter on the Location Directory
If you use Waitwhile’s Location Directory to display multiple service locations, you can apply query parameters to filter which locations appear based on criteria such as city, state, visit type, or custom label. This is especially useful when linking from an external system or customizing the customer experience—for example, showing only locations in a specific region or those offering a particular service.
Pre-filter locations based on city, state, zip using custom labels →
LabelPre-filter locations based on services offered - Service ID →
Service IDPre-filter locations based on the registration type offered - Booking and/or waitlist →
Registration type
Example:
https://waitwhile.com/accounts/waitwhiledemo?label=Region:Georgia
Label:
label=Area:North&label=City:Stockholm&label=City:GothenburgService ID:
service=ZcB3NT83tIH1IsMnPwrtRegistration type:
registration=waitlist®istration=booking
4. To filter the All Waitlists page
The All Waitlist page in Waitwhile enables both staff and customers to view multiple queues across different locations. This is especially useful in environments where a single business location has several departments or service areas—such as Returns & Exchanges, Repairs, and Fitting Rooms in a retail store. By using query parameters in the URL, you can filter the page to display only specific queues within a particular location, even when multiple locations are managed under the same Waitwhile account.
Pre-filter locations based on city, state, zip using custom labels →
LabelPre-filter locations based on services offered - Service ID →
Service ID
Example
https://waitwhile.com/accounts/waitwhiledemo/waitlists?label=Store:Upstore
Label:
label=Area:North&label=City:Stockholm&label=City:GothenburgService ID:
service=ZcB3NT83tIH1IsMnPwrt
Tips & Tricks when using query parameters
Question mark (?) indicates the actual query. (ex. first name)
Ampersand (&) indicates multiple queries. (ex. first and last name)
Equal sign (=) will come before the value of the query. (ex. John)
Percent + 20 (%20) indicates a space that should be added. (ex. John Doe)
Have additional questions or need assistance? Reach out to us via chat or at support@waitwhile.com.