In this article, we’ll explain you how to link to your booking engine and specific offers, dates and/or languages.

1. Request the URL of your Booking Page

  • We have created a standard module that can be used for every website, regardless of the booking engine that is used.
  • For this module, we have set up a page for your website, which is redirected to the booking engine.
  • You can easily retrieve this URL via your contact person at The Orange Studio.
  • Usually, the URL slug entails e.g. /bookings or /reservations.


2. Options to Customize the URL

Now you should already have the basis of the URL. E.g. https://www.theorangestudio.com/ 

  • By adding several so-called ‘parameters’ to the URL, we can tell the booking engine to open on a specific date, in a specific language or for a specific offer.
  • These parameters are added to the URL as a short part of code. 
  • You can add a parameter for language, promo code, number of persons, special offer, specific room type, from date, till date and/or let the engine open in a specific step.


Below you can see a list of the standardized terms (parameters):
    • language > if you wish to link to a specific language, you add a URL slug. The page URL stays the same (‘bookings’)
    • promo-code > ?promo-code=…
      • E.g.: ?promo-code=BOOKDIRECT
    • nr-of-persons
      • E.g.:  nr-of-persons=5
    • specific ID
      • E.g.: id=b39ca607-1859-47cc-be28-ad480118ddb2
    • from
      • E.g. from=31-12-2021
    • till
      • E.g. till=01-01-2022
    • step-2 > if you wish to skip the date-section of the booking engine
      • E.g.: step-2=true
    • open-room > to open a specific room type
      • E.g. open-room=suite
    • location > specifically for hotel groups
      • E.g. location=amsterdam-west


3. Create the Customized URL

Now you have all the needed information to create the customized URL. The only things you need to keep in mind:

  • You’ll need to add a question mark behind the URL slug of the booking page (you retrieved through OHM)
  • You need to use a &-mark in between every parameter to separate them and show that another parameter is following the previous one.


3.1 Setting up the URL

  • Now it’s time to add the parameters to the URL that you wish to specify.
  • There is not a fixed order, so feel free to mix the order up – this won’t cause any issues.
  • You can also decide to leave out some of the parameters, and only add one or two for example.


Let’s say you want to create a Dutch URL for your special New Year’s Offer for couples, that features a Suite in the package. You could create the URL as following:
  1. Basis of the URL: https://www.theorangestudio.com/
  2. Add the question mark: https://www.theorangestudio.com/?
  3. Add the specific location (optional for hotel groups only): https://www.theorangestudio.com/?location=amsterdam-west
  4. Add the &-mark: https://www.theorangestudio.com/bookings?id=b39ca607-1859-47cc-be28-ad480118ddb2&
  5. Add a specific ID for a special: https://www.theorangestudio.com/bookings?location=amsterdam-west&id=b39ca607-1859-47cc-be28-ad480118ddb2
  6. Add the number of persons (it’s an offer for a couple): https://www.theorangestudio.com/bookings?location=amsterdam-west&id=b39ca607-1859-47cc-be28-ad480118ddb2&lang=nl&nr-of-persons=2
  7. Add the specific room type (it’s for a suite): https://www.theorangestudio.com/bookings?id=b39ca607-1859-47cc-be28-ad480118ddb2&lang=nl&nr-of-persons=2&open-room=suite
  8. Add the specific dates (it’s for new year’s, so from 31/12 till 01/01): https://www.theorangestudio.com/bookings?location=amsterdam-west&id=b39ca607-1859-47cc-be28-ad480118ddb2&lang=nl&nr-of-persons=2&open-room=suite&from=21-12-2021&till=01-01-2022
  9. Add the promo code: https://www.theorangestudio.com/bookings?location=amsterdam-west&id=b39ca607-1859-47cc-be28-ad480118ddb2&lang=nl&nr-of-persons=2&open-room=suite&from=21-12-2021&till=01-01-2022&promo-code=NEWYEAR
  10. If you wish to link to a translation, you can add the language URL slug as well: https://www.theorangestudio.com//nl/bookings?location=amsterdam-west&id=b39ca607-1859-47cc-be28-ad480118ddb2&lang=nl&nr-of-persons=2&open-room=suite&from=21-12-2021&till=01-01-2022&promo-code=NEWYEAR

This URL can then be added to any button, image or textlink within your website.


4. Add the Link to a Button, Image or Textlink

Read further in this article, on how to add the link to any element within the desired page: How to Add a (External or Internal) Link or Anchor Link