Custom URLs provide direct links for guests to receive special group rates and other parameters set by room blocks. In this article, learn how to create URLs with room and stay parameters.
Setting Parameters in the URL—Keys to Success
Take note of these keys to success before building custom URLs:
- All the parameters in this article are available for both Step 1 and Step 2.
- Indicate the group's custom parameters within the the text of the URL. Parameters appear after the question mark (?) that follows the booking step. For example, to restrict bookings to 2 adults, the URL will contain this text: https://brand.com/#/booking/step-1?adults=2
Note the parameter (adults=2) that follows the question mark. - RevRaise supports multiple languages, and custom URLs can send guests directly to translated versions of the site (selected language must be configured).
- If the custom URL will contain a group or promo code, create those codes first.
- URLs can accommodate as many supported parameters as you would like, separated by ampersands (&). For example, this URL is for a group that requires these parameters. Note the ampersands that separate each parameter.
https://www.thedoldergrand.com/en/booking/step-1?arrive=06%2F27%2F2024&depart=07%2F01%2F2024&group=SW25&children=0
Arrival Date: June 27, 2024
Departure Date: July 1, 2024
Group Code: SW25
Number of Children: 0
Steps to Create Custom URLs
- Copy the existing URL from the Booking Engine for Step 1, Step 2, or both.
- Paste the URL where it can be edited: A new browser window, Notepad, Google Doc, etc.
- Edit the URL to include custom parameters using the URL Text codes in the table below.
-
Test the URL in a new browser window to ensure parameters appear correctly in the Booking Engine. Some hotels are given as examples, but you need to generate your own urls.
Hotel Multirooms Parameters Direct link Expected Result STEP 1 lead, nightly-price IMPORTANT: Calendar-> Nightly price must be ON in admin
https://azdsbooking-qa1.azds.com/hotel/ali-pasha#/booking/step-1?lead=10&nightly-price=falseArrival = current date + lead, Departure = Arrival +1
Prices are not displayed in calendar cells.accessible IMPORTANT: 'ADA Accessible' feature must be ON in admin
https://azdsbooking-qa1.azds.com/hotel/rally#/booking/step-1?accessible=trueShow only accessible rooms' checkbox is displayed and checked. arrive, depart, adults, children, child age https://azdsbooking-qa1.azds.com/hotel/le-bristol#/booking/step-1?arrive=04/01/2024&depart=04/02/2024&adults[0]=1&children[0]=2&child_age[0][0]=8&child_age[0][1]=3
https://azdsbooking-qa1.azds.com/hotel/le-bristol#/booking/step-1?arrive=04/01/2024&depart=04/02/2024&adults=1&children=2&child_age[0][0]=8&child_age[0][1]=3Step 1 for Le Bristol hotel is opened in the state :
Arrival = 04/01/2024, Departure = 04/02/2024
Adults = 1, children = 2, children age = 8, children age = 3promo, currency, rooms https://azdsbooking-qa1.azds.com/hotel/nobis-blique#/booking/step-1?promo=KFPROD¤cy=CAD&rooms=2 Step 1 is opened:
Rooms = 2
Promo code = 'KFPROD'
Currency 'Canadian dollar' is selected in dropdown.ratePlan IMPORTANT: Special Rates-> 'Hide on dates step' checkbox should be off in admin
https://azdsbooking-qa1.azds.com/hotel/graduate-a#/booking/step-1?arrive=03/20/2024&ratePlan[0]=MEMBR&depart=03/21/2024Step 1 is opened:
Special Rates field is set to 'Rate:MEMBR' and is applied to calendar availability.group,room https://azdsbooking-qa1.azds.com/hotel/chalet-view-lodge#/booking/step-1?arrive=11/16/2023&group=KELLYDREW23&depart=11/17/2023&room=AIRSTREAM,TKGR,TRST Step1 is opened:
'KELLYDREW23' group code is displayed in the field on step 1 and step 2 and is applied to calendar availability.
Step 2
'KELLYDREW23' group code is displayed in the field.
Only rooms with AIRSTREAM,TKGR,TRST are displayed in the list.
AIRSTREAM - Airstream
TKGR - Standard King Guest Room
TRST - Terrace Suiteroom https://azdsbooking-qa1.azds.com/hotel/mdv#/booking/step-1?&room=HPKS
https://azdsbooking-qa1.azds.com/hotel/don-cesar#/booking/step-1?&room=GRDD2
https://azdsbooking-qa1.azds.com/hotel/mdv#/booking/step-1?arrive=02/01/2024&depart=02/03/2024&room=HPKS
https://azdsbooking-qa1.azds.com/hotel/don-cesar#/booking/step-1?arrive=02/04/2024&depart=02/06/2024&room=GRDD2Step 1 - Displays a calendar of available dates for a specific room.
Step 2 - Only room with HPKS (GRDD2) are displayed in the list.
Step 1 - Arrival = 02/01/2024, Departure = 02/03/2024
Arrival = 02/04/2024, Departure = 02/06/2024
Step 2 - Only room with HPKS (GRDD2) are displayed in the list.step 1 case when url contains parameters for step 2 (roomsorder, filters, room , category, rate, ) https://azdsbooking-qa1.azds.com/hotel/grande-colonial#/booking/step-1?arrive=03/03/2024&depart=03/05/2024&children=1&adults=1&roomsorder=lowest&beds=1&category=ocean_view_rooms___suites&rate=BAR Step 1 is opened.
Step 2 parameters impacted on calendar and rooms availability on step 1 and step 2negative case when url contains parameters for modify step https://azdsbooking-qa1.azds.com/hotel/cavallo-point#/booking/step-1?lead=10&children=2&adults=1&roomsorder=lowest&views=property&beds=1&room_type=contemporary&email=eshpakovskaya%40azds.com&reservationId=27398CK025497&submit=1 Step 1 is opened for Cavallo Point Sausalito hotel.
Parameters for modify step are ignored.STEP 2 lead https://azdsbooking-qa1.azds.com/hotel/graduate-a#/booking/step-2?lead=10 Arrival = current date + lead
Departure = Arrival +1accessible, roomsorder IMPORTANT: 'ADA Accessible' feature must be ON in admin
https://azdsbooking-qa1.azds.com/hotel/graduate-a#/booking/step-2?accessible=true&arrive=02/01/2024&depart=02/03/2024&roomsorder=highestShow only accessible rooms' checkbox is displayed and checked.
Only accessible rates are displayed in the list.
Rooms are displayed from the highest price to the lowest.group https://azdsbooking-qa1.azds.com/hotel/chalet-view-lodge#/booking/step-2?arrive=11/16/2023&group=KELLYDREW23&depart=11/17/2023 Step 2 is opened:
'KELLYDREW23' group code is displayed in the field in the room block.
Only rates with applied group code are displayed in the list.arrive, depart, adults, children, childAge https://azdsbooking-qa1.azds.com/hotel/le-bristol#/booking/step-2?arrive=04/01/2024&depart=04/02/2024&adults[0]=1&children[0]=2&child_age[0][0]=8&child_age[0][1]=3
https://azdsbooking-qa1.azds.com/hotel/le-bristol#/booking/step-2?arrive=04/01/2024&depart=04/02/2024&adults=1&children=2&child_age[0][0]=8&child_age[0][1]=3Step 2 for Le Bristol hotel is opened in the state:
Arrival = 04/01/2024, Departure = 04/02/2024
Adults=1, children=2, children age = 8, children age = 3
All parameters above are applied to the displayed rates.promo, currency, rooms https://azdsbooking-qa1.azds.com/hotel/nobis-blique#/booking/step-2?promo=KFPROD&arrive=12/30/2023&depart=12/31/2023¤cy=CAD&rooms=2 Step 2 is opened:
Two rooms are displayed in a room block.
'KFPROD' promo code is displayed in the field for the 1st room.
Only rates with applied promo code are displayed in the list.
Currency 'Canadian dollar' is selected in dropdown.
Rate prices are displayed in Canadian dollar.ratePlan https://azdsbooking-qa1.azds.com/hotel/graduate-a#/booking/step-2?arrive=03/20/2024&ratePlan[0]=MEMBR&depart=03/21/2024 Step 2 is opened:
'MEMBR' special rate is displayed in the field in the room block.
Only rates with applied special rate are displayed in the list.filters applied from admin panel https://azdsbooking-qa1.azds.com/hotel/mdv#/booking/step-2?rooms=1&arrive=02/27/2024&depart=02/28/2024&views=vista_view&bedrooms=2 Hotels is opened on step 2. Following filters are set on step 2 and applied to rates list:
Views = Vista View
Bedrooms = 2room https://azdsbooking-qa1.azds.com/hotel/castle-hot-springs#/booking/step-2?room=SVC,FSV&arrive=04/18/2024&depart=04/21/2024
https://azdsbooking-qa1.azds.com/hotel/mdv#/booking/step-2?arrive=02/01/2024&depart=02/03/2024&room=HPKS
https://azdsbooking-qa1.azds.com/hotel/don-cesar#/booking/step-2?arrive=02/04/2024&depart=02/06/2024&room=GRDD2Step 2 for Castle Hot Spring is opened:
Only rooms with ‘SVC' or/and 'FSV’ are displayed in the list
SVC - Sky View Cabin; FSV - Flexible Sky View Cabin
Step 2 for Montage Deer Valley is opened:
Only rooms with ‘HPKS’ are displayed in the list' HPKS” - Peak View Suites
Step 2 for The Don Cesar is opened:
Only rooms with ‘GRDD2’ are displayed in the list'; GRDD2” - Grand Two Queenscategory https://azdsbooking-qa1.azds.com/hotel/don-cesar#/booking/step-2?arrive=03/03/2024&depart=03/04/2024&category=standard_room Step 2 for Don Cesar hotel is opened.
‘Standard Room’ category block is only displayed and contains rooms that assigned to this category.rate https://azdsbooking-qa1.azds.com/hotel/graduate-a#/booking/step-2?arrive=03/01/2024&depart=03/02/2024&rate=DISMMBRAP Step 2 is opened for Ann Arbor hotel.
Only rate with code 'DISMMBRAP' (Login + Save Prepay)is displayed under every room in the list.redirect to step 2 https://azdsbooking-qa1.azds.com/hotel/nobis-blique#/booking/step-3?promo=KFPROD&arrive=12/30/2023&depart=12/31/2023¤cy=CAD&rooms=2 User is redirected to step 2 with parameters from the link. negative case when url contains parameters for modify step https://azdsbooking-qa1.azds.com/hotel/graduate-a#/booking/step-2?lead=10&email=eshpakovskaya%40azds.com&reservationId=27398CK025497&submit=1 Step 2 is opened for Ann Arbor hotel.
Parameters for modify step are ignored.Modify Modify, email, reservationId https://azdsbooking-qa1.azds.com/hotel/mdv-demo#/booking/modify?email=eshpakovskaya%40azds.com&reservationId=27398CK025497&submit=1 Modify screen for eshpakovskaya@azds 27398CK025497 is opened. negative case when url contains parameters for step 2 and step 1 https://azdsbooking-qa1.azds.com/hotel/mdv-demo#/booking/modify?email=eshpakovskaya%40azds.com&reservationId=27398CK025497&submit=1&category=standard_room&rate=DISMMBRAP&lead=10&arrive=05/30/2024&group=2-ISWHI&depart=05/31/2024&ratePlan[0]=MEMBR&promo=KFPROD¤cy=CAD&rooms=2&adults[0]=1&children[0]=2&child_age[0][0]=8&child_age[0][1]=3&accessible=true&nightly-price=on&roomType=suite&room=SVC,FSV Modify screen for eshpakovskaya@azds 27398CK025497 is opened
Step2 and Step1 parameters are ignored.Destination Multihotels: lead, hotel https://azdsbooking-qa1.azds.com/destination/oetker#/booking/dates?lead=10&hotel=le-bristol ‘Select dates’ screen is opened with following dates:
Arrival = current date + lead, Departure = Arrival +1
'Le Bristol Paris' + arrival and departure are displayed on a top of calendar.exclusiveHotelCode https://azdsbooking-qa1.azds.com/destination/oetker#/booking/destination/dates?lead=10&exclusiveHotelCode=le-bristol ‘Select dates’ screen is opened, selected hotel is predefined, if user go further - map step will be skipped, user is redirected to rooms step of defined hotel. Works only when multihotel=OFF dates https://azdsbooking-qa1.azds.com/destination/oetker#/booking/step-1
https://azdsbooking-qa1.azds.com/destination/oetker#/booking/destination/dates‘Select dates’ screen is opened in default state:
Arrival = empty, Departure = empty
Adults = 2, children = 0Select dates
arrive, depart, adults, children, child age, promo, currencyhttps://azdsbooking-qa1.azds.com/destination/oetker#/booking/destination/dates?arrive=03/03/2024&adults=1&children=1&child_age[0][0]=8&depart=03/04/2024&promo=ROMANCE¤cy=USD
https://azdsbooking-qa1.azds.com/destination/oetker#/booking/step-1?arrive=03/03/2024&adults=1&children=1&child_age[0][0]=8&depart=03/04/2024&promo=ROMANCE¤cy=USD‘Select dates’ screen is opened in the state:
Arrival = 03/03/2024, Departure = 03/04/2024
Adults = 1, children = 1, children age = 8
'ROMANCE' promo code is displayed in the field.
USD currency is selected in dropdown.group https://azdsbooking-qa1.azds.com/destination/oetker#/booking/destination/dates?arrive=03/03/2024&adults=1&children=1&child_age[0][0]=8&depart=03/04/2024&group=BAR ‘Select dates’ screen is opened
'BAR' code is displayed in Group Code field.step1 case when url contains parameters for step2 (filters, room , category, rate) https://azdsbooking-qa1.azds.com/destination/elgouna#/booking/hotels?lead=10&hotel=steigenberger-resort-el-gouna&category=suite&bedconfig=king&room=DK,SUPK&rate=BAR ‘Select dates’ screen is opened with following dates:
Arrival = current date + lead, Departure = Arrival +1
'Steigenberger Golf Resort' + arrival and departure are displayed on a top of calendar
Hotels step parameters impacted on calendar and rooms availabilitynegative case when url contains parameters for modify step https://azdsbooking-qa1.azds.com/destination/elgouna#/booking/hotels?lead=10&hotel=steigenberger-resort-el-gouna&email=eshpakovskaya%40azds.com&reservationId=27398CK025497&submit=1 Step 1 is opened for 'Steigenberger Golf Resort' hotel
Parameters for modify step are ignoredHotels lead, hotel IMPORTANT: Multi-hotel Settings → checkbox should be on in admin
https://azdsbooking-qa1.azds.com/destination/elgouna#/booking/destination/hotels?lead=10&hotel=steigenberger-resort-el-gounaHotels list is opened :
Arrival = current date + lead, Departure = Arrival +1
Hotels list is displayed according to arrival and departure
Steigenberger Golf Resort hotel is preselectedexclusive hotel code https://azdsbooking-qa1.azds.com/destination/oetker#/booking/destination/hotels?lead=10&exclusiveHotelCode=le-bristol User redirected to step 1 and hotel is predefined, if user go further - map step will be skipped, user is redirected to rooms step of defined hotel. Works only when multihotel=OFF arrive, depart, adults, children, child age, promo, currency https://azdsbooking-qa1.azds.com/destination/graduate#/booking/destination/hotels?arrive=03/01/2024&adults=1&children=1&child_age[0][0]=8&depart=03/02/2024&promo=SMART¤cy=USD&hotel=graduate-a Hotels list is opened for parameters:
Arrival = 03/01/2024, Departure = 03/02/2024
Adults = 1, children = 1, children age = 8
'SMART' promo code is applied to displayed hotels
USD currency is selected in dropdowngroup https://azdsbooking-qa1.azds.com/destination/graduate#/booking/destination/hotels?arrive=03/01/2024&depart=03/02/2024&group=BAR Hotels screen is opened
Only hotels that have rates valid for 'BAR' group code are displayed in the listhotelprice, hotelsorder, hotelslocation, currency https://azdsbooking-qa1.azds.com/destination/elgouna#/booking/destination/hotels?arrive=02/01/2024&depart=02/03/2024¤cy=USD&hotelsorder=alphabetically&hotelslocation=Hurghada%7CEl%20Gouna&hotelsprice=50-90 Hotels list is displayed
'Euro' currency is displayed in dropdown
All hotels prices are displayed in EUR
Only hotels that have rooms in price range [50..90 EUR] are displayed in the list
Hotels are displayed in alphabetical order
Hotels with location Hurghada and El Gouna are displayed in the listnegative case when url contains parameters for step2 https://azdsbooking-qa1.azds.com/destination/nobis#/booking/destination/hotels?lead=10&hotel=nobis-stockholm&accessible=true&roomsorder=highest&roomTypes=suite&rooms=2&rate=AAA&room=GKG,GQQ Hotels list is opened :
Arrival = current date + lead, Departure = Arrival +1
Hotels list is displayed according to arrival and departure
Nobis Stockholm hotel is preselected
Step2 parameters impacted on hotels availabilityRooms arrive, depart, adults, children, child age, promo, currency, hotel https://azdsbooking-qa1.azds.com/destination/oetker#/booking/step-2?arrive=06/20/2024&adults=1&children=1&child_age=8&depart=06/30/2024&hotel=le-bristol&promo=SEMAINE¤cy=USD Le Bristol hotel is opened on step2
Arrival = 06/20/2024, Departure = 06/30/2024
Adults = 1, children = 1, children age = 8
SEMAINE promo code is displayed in the field
SEMAINE promo code is applied to rates list
USD currency is selected in dropdown
Rates prices are displayed in USD currencyexclusiveHotelCode https://azdsbooking-qa1.azds.com/destination/oetker#/booking/step-2?arrive=06/20/2026&adults=1&children=1&depart=06/30/2026&exclusiveHotelCode=le-bristol Step2 is open for defined hotel, if user go back - map step will be skipped. Works only when multihotel=OFF group, accessible, roomsorder, hotel https://azdsbooking-qa1.azds.com/destination/graduate#/booking/step-2?arrive=03/01/2024&depart=03/02/2024&hotel=graduate-a&group=BAR&accessible=true&roomsorder=lowest Step2 is opened for Ann Arbor hotel
'BAR' code is displayed in Group Code field in room block
Only rates applicable for 'BAR' group code are displayed in the list
Rooms are displayed from the lowest price to the highestratePlan, hotel, rooms, rate, lead, filters applied from admin panel https://azdsbooking-qa1.azds.com/destination/elgouna#/booking/step-2?lead=10&hotel=steigenberger-resort-el-gouna&bedconfig=king&room=DK,SUPK&ratePlan=BAR&rate=MO10 Step 2 is opened for Ann Arbor hotel:
There 2 rooms in rooms block.
'MEMBR' special rate is displayed in the field in the room block.
Only rates with applied special rate and 'AAA Member Rate' are displayed in the list.
Only rooms of Suite type are displayed in the list.
Arrival = current date + lead, Departure = Arrival +1room, hotel https://azdsbooking-qa1.azds.com/destination/graduate#/booking/step-2?arrive=03/01/2024&adults=1&children=1&depart=03/02/2024&hotel=graduate-a&room=GKG,GQQ Step 2 for Ann Arbor hotel:
Only Graduate King and/or Graduate Queen Queen rooms are displayed in the listthere is no 'hotel' but step 2 in url https://azdsbooking-qa1.azds.com/destination/nobis#/booking/step-2?adults=5&arrive=06/20/2024&depart=06/30/2024 ‘Select dates’ screen for Nobis hotel is opened in the state:
Arrival = 06/20/2024, Departure = 06/30/2024
Adults = 5, children = 0negative case when url contains parameters for modify step https://azdsbooking-qa1.azds.com/destination/elgouna#/booking/step-2?lead=10&hotel=steigenberger-resort-el-gouna&adults=1&children=1&child_age[0][0]=8&email=eshpakovskaya%40azds.com&reservationId=27398CK025497&submit=1 Le Bristol hotel is opened on step 2
Arrival = 06/20/2024, Departure = 06/30/2024
Adults = 1, children = 1, children age = 8
Parameters for modify steps are ignored.Modify modify, reservation https://azdsbooking-qa1.azds.com/destination/oetker#/booking/destination/modify?email=email&reservation=reservation_number&hotel=azds_booking_code&submit=1 Modify screen is opened for specific reservation and hotel. negative case when url contains parameters for dates, hotels, step 2 https://azdsbooking-qa1.azds.com/destination/oetker#/booking/destination/modify?email=test@azds.com&reservation=111&hotel=azds&submit=1&rate=DISMMBRAP&arrive=05/30/2024&group=2-ISWHI&depart=05/31/2024&ratePlan[0]=MEMBR&promo=KFPROD¤cy=CAD&rooms=2&adults[0]=1&children[0]=2&child_age[0][0]=8&child_age[0][1]=3&accessible=true&roomsorder=highest&roomTypes=suite&hotelsorder=alphabetically&hotelsarea=DownTown&hotelslocation=Hurghada%7CEl%20Gouna Modify screen is opened for specific reservation and hotel.
Dates, hotels, step 2 parameters are ignored.
For Additional Support
Click here to complete the Support Request Form*.
- Your email address—a support agent will reply via email.
- Subject—Provide the property name and issue title.
- Description—describe the issue in detail.
- Priority—accurately* indicate the level of the request (low, normal, high or urgent). *Selecting the correct priority level ensures the request is routed to the correct agent.
- My request is for the following— indicate the request is for Booking Engine (RevRaise).
- Attachments (if applicable)—attach relevant docs/images.
- Click Submit.
Zendesk will generate a ticket number. To check the status of the ticket, click here and enter the ticket number in the Search field on the left side of the screen.