Browse docs
On this page

Embed a Vally Calendar on Your Website

Add a Vally availability calendar to your website. Embed one trip or all activities, connect the booking widget, and customize calendar colors.

Playback speed: 1×

You can embed one trip calendar or your complete Vally calendar on your website so customers can view availability and start a booking.

Before you start

Install the Vally booking widget once in your website’s <head>. The calendar uses that script to open the booking page when a customer chooses dates and continues. If you only want the calendar on your page, add data-button="false" to the widget script to hide its floating Book Now button.

Use the business slug from your booking page URL. In https://book.vallypro.com/p/peacock-adventures, the slug is peacock-adventures. For an individual trip, also copy the trip ID from its URL, after /trips/.

Paste the iframe code into the HTML section of the page where the calendar should appear. Replace the placeholders with your own business slug and trip ID before publishing.

Individual Trips Calendar

Default Embed Code

Use this example to show availability for one trip:

<iframe
  title="Trip availability"
  sandbox="allow-forms allow-modals allow-scripts allow-popups allow-same-origin"
  style="width: 400px; height: 600px"
  src="https://book.vallypro.com/embed/your-business-slug/trips/your-trip-id/calendar">
</iframe>
  • Replace your-business-slug and your-trip-id with the values from your booking page.
  • The width and height can be adjusted if needed.
  • The default calendar look will be applied:
  • Default Vally calendar embed

Customization Options

Add ? before the first setting in the iframe URL. Separate later settings with &amp; in HTML code, or & when working with the URL itself.

Encode spaces as %20 and the # in a hex color as %23. A literal # starts a URL fragment, so the calendar will not receive the rest of your settings.

SettingWhat it changesDefault when omitted
title=Book%20NowHeading above the calendarNo heading
titleColor=%23FFFFFFHeading text colorBlack
background=%237BB246Background around the calendar#fcfcfc
buttonColor=%23000000Done button backgroundVally’s standard button style
buttonTextColor=%23FFB300Done button text colorVally’s standard button style

Customized Example:

<iframe
  title="Trip availability"
  sandbox="allow-forms allow-modals allow-scripts allow-popups allow-same-origin"
  style="width: 400px; height: 600px"
  src="https://book.vallypro.com/embed/your-business-slug/trips/your-trip-id/calendar?title=Book%20Now&amp;titleColor=%23FFFFFF&amp;background=%237BB246&amp;buttonColor=%23000000&amp;buttonTextColor=%23FFB300">
</iframe>
  • Title: Book Now
  • Title color: White (FFFFFF)
  • Background color: Green (7BB246)
  • Button color: Black (000000)
  • Button text color: Orange/Yellow (FFB300)
  • Example appearance: Dates and availability will reflect your own trip.
  • Customized Vally calendar embed

Global Calendar

The global calendar displays your publicly visible activities. Replace your-business-slug with your business slug:

<iframe
  title="Activity availability"
  sandbox="allow-forms allow-modals allow-scripts allow-popups allow-same-origin"
  src="https://book.vallypro.com/embed/your-business-slug"
  style="width: 400px; height: 680px;">
</iframe>

An example of the default Global Calendar:

Complete Vally calendar embed

If you want the calendar to show only some of your trips:

  1. Add ?service=your-trip-id to the URL to show one trip.
  2. Repeat service to show several trips. In the HTML src attribute, use ?service=trip-id-1&amp;service=trip-id-2 and replace both trip IDs.

Check your calendar

Preview your website on desktop and mobile. Confirm that the intended activities and calendar colors appear, then choose dates and continue to the booking page without submitting a booking. With the widget’s default settings, booking continues in a popup on desktop and a new tab on screens narrower than 1024 pixels. See the booking widget guide for mobile popup settings.

If the calendar appears but continuing does nothing, check that the booking widget script is installed on the same page. If colors are missing, check for a literal # in the iframe URL and replace it with %23.