How to customise RMS Booking Engine URLs using path and query parameter modifiers to pre‑set search options, filter to specific Categories or Areas, and apply promo codes.
Overview
The RMS Booking Engine automatically generates an encrypted URL that you can use as a Book Now link on your property website.
You can extend this URL with URL modifiers to:
Pre‑set arrival and departure dates
Pre‑select the number of guests
Filter to a specific Category or Area
Apply a Promo Code / Discount
Control how availability is displayed
These modifiers consist of:
Path segments – elements that start with / and are appended directly to the Booking Engine path, and
Query parameters – key/value pairs added after the first ? in the URL and separated by &.
URL Syntax & Structure
A typical RMS Booking Engine URL looks like:
https://bookings.rmscloud.com/Search/Index/ABCD1234/1
You can then add:
Path modifiers directly after the encrypted path, e.g.:
https://bookings.rmscloud.com/Search/Index/ABCD1234/1/W/Z
Query parameters after a single ?, e.g.:
https://bookings.rmscloud.com/Search/Index/ABCD1234/1/W/ZA=MM/DD/YYYY&D=MM/DD/YYYY&Ad=X&C=X&Pc=XXXX
Key Rules
Use only one ? in the URL before the first query parameter.
Use & between subsequent query parameters.
Do not repeat ? for each parameter.
Path modifiers (like /W/Z) must appear in the correct position immediately after the encrypted URL path so the Booking Engine can correctly apply Category/Rate filters.
URL Modifiers Reference
The following table lists each supported modifier, its format, and what it controls.
| Order | Element | Description |
|---|---|---|
| 1 | /W/Z | W = RMS Category ID (room type) & Z = Rate Type ID |
| 2 | /?Ct=WW | WW = RMS Category ID (Category to filter to) |
| 3 | /?Ar=XX | XX = RMS Area ID (specific Area to filter to) |
| 4 | /Y=1 | Exposes the physical number of Areas available for each Category & Date searched. |
| 5 | ?&A=MM/DD/YYYY | MM/DD/YYYY = Arrive Date (Month/Day/Year) |
| 6 | ?&D=MM/DD/YYYY | MM/DD/YYYY = Depart Date (Month/Day/Year) |
| 7 | ?&Ad=X | X = Number of Adults |
| 8 | ?&C=X | X = Number of Children |
| 9 | ?&I=X | X = Number of Infants |
| 10 | ?&Pc=XXXX | XXXX = Discount Name/Promo Code |
Path vs Query Modifiers
Elements that begin with / (for example, /W/Z, /?Ct=WW, /?Ar=XX, /Y=1) are part of the path and must appear immediately after the encrypted Booking Engine URL.
Elements like A, D, Ad, C, I, Pc are query parameters added after the ? at the end of the URL.
Finding Category & Area IDs in RMS
To create Category‑specific or Area‑specific booking links, you need the relevant IDs from RMS.
-
RMS Category ID (room type)
Go to Setup > Property Options > Categories.
The Category ID is shown in the Categories list or on the Category edit screen.
-
RMS Area ID (individual room/space)
Go to Setup > Property Options > Areas.
The Area ID is shown in the Areas list or on the Area edit screen.
Use these IDs in your URL modifiers (for example, /W/Z, /?Ct=WW, /?Ar=XX) to pre‑select or filter to those Categories or Areas in the Booking Engine.
Query Parameter Syntax
When adding query parameters:
Start the query string with ? followed by the first parameter, for example:
?A=06/20/2026Add each additional parameter with &, for example:
&D=06/30/2026&Ad=2&C=0&I=0Do not include ? or & inside the values themselves, only between parameters in the URL.
Example with placeholders:
https://bookings.rmscloud.com/Search/Index/ABCD1234/1/W/ZA=MM/DD/YYYY&D=MM/DD/YYYY&Ad=X&C=X&Pc=XXXX
Example with sample values:
https://bookings.rmscloud.com/Search/Index/ABCD1234/1/3/4A=06/20/2026&D=06/30/2026&Ad=4&C=2&Pc=Discount
These examples demonstrate:
A path that includes Category and Rate (/1W/Z or /1/3/4).
A single ? starting the query string.
All subsequent parameters joined with &.
Recommended Parameter Order
To avoid confusion and ensure all filters are applied correctly:
Start with the Booking Engine URL generated in RMS.
Add path modifiers (such as /W/Z, /?Ct=WW, /?Ar=XX, /Y=1) in the order shown in the table.
Add the first query parameter with ? (typically A for Arrive Date).
Add any additional parameters (D, Ad, C, I, Pc) separated by &.
If they are not placed correctly, the Booking Engine may ignore them or may not load the expected
Category / Rate combination.
Query parameters can generally be in any order after the ?, but following the documented order helps keep URLs consistent and reduces errors.
Using the URL Generator in RMS
In the side menu of RMS, go to Setup > Online Bookings > Online Options.
Navigate to the URL Generator tab.
Select a Property or choose Enterprise.
-
Select Copy IBE URL.
Please share this URL with the property website designer so they can add it as a “Book Now” button link on your property website.
Append the required path segments and query parameters as described in this article to customise the booking experience.
Comments
0 comments
Please sign in to leave a comment.