Managing Retreats in Mangobeds

If you sell retreats, yoga weeks, wellness packages or any fixed-date experience, Mangobeds has a dedicated Retreats app. Each retreat is its own listing with its own dates, per-room pricing, custom guest questions, online payments and a public landing page.

Before you start

  • The accommodations you want to include in the retreat already created in your property (with their normal coliving / short-stay pricing). See How to Create Accommodations in Mangobeds if you haven’t set yours up yet.
  • A booking form set up the way you want retreats to be booked. It carries the things that don’t change between retreats: extras catalog, custom guest questions, terms & conditions URL, payment behavior (deposit %, save card details, etc.). One booking form can serve many retreats, so most properties only need a single “Retreats” booking form. See Getting Bookings From Your Website With Mangobeds if you haven’t set one up yet.
  • Optional: a payment account connected to the property if you want to take deposits or full payment online. See Payment Accounts and Online Payments for how to connect one.

Create your first retreat

  1. Open Property → Apps → Retreats.
  2. Click Create retreat.
  3. Fill in:
    • Title — what shows on the public retreats page and the detail page (e.g. Nature Adventure Holiday).
    • Description — the long-form pitch. What’s included, what guests will experience, anything they need to know before they book.
    • Start date / End date — the exact retreat window. Bookings are locked to these dates.
    • Booking form — pick the form you set up earlier. This is what the retreat reuses for extras, custom guest questions, terms and payment behavior.
    • Images — hero photo + gallery shots.
    • Included accommodations & pricing — check the accommodations that are sellable for this retreat. For each one, enter the total all-inclusive price for the whole retreat.
    • Disabled (optional) — tick this to keep the retreat off the public page while you finalize it. Untick to publish.
  4. Click Create. The retreat appears in the grid and on the public retreats page.

Add the retreats to your website

Every property gets a public retreats page that lists every upcoming, non-disabled retreat sorted by start date. Each retreat also has its own public page. You can either link guests to those pages, or embed them inside your own website so they look like a native part of it.

At the top of the Retreats app you’ll find a card with the URL plus two buttons: Preview opens the public page in a new tab, and Add to my web opens a dialog with both options below. Each retreat card has the same options in its 3-dot menu under Share.

Option 1: Share the link

  1. Open Property → Apps → Retreats for the public retreats page link, or open the 3-dot menu on a retreat card and click Share for a single retreat link.
  2. Click Add to my web, then click Copy link in Option 1.
  3. Paste the link into your website. Add it to a button, text or banner. When users click it, they will be taken to the public page to browse and book.

Option 2: Embed the retreats into your website

  1. Open Property → Apps → Retreats and click Add to my web for the full retreats list, or open the 3-dot menu on a retreat card and click Share for a single retreat.
  2. Click Copy script in Option 2. This copies the full Mangobeds retreats widget code, a small <script> snippet, to your clipboard.
  3. Paste the snippet into the HTML of your website where you want the retreats to appear. The widget loads the page, resizes it automatically to fit, and stays in sync with whatever you publish in Mangobeds.

The snippet for the full retreats list looks like this:

<script async data-property-id="PROPERTYID" src="https://mangobeds.com/js/widget/retreats.js"></script>

For a single retreat, the snippet also carries a data-retreat-id:

<script async data-property-id="PROPERTYID" data-retreat-id="RETREATID" src="https://mangobeds.com/js/widget/retreats.js"></script>

Important: do not embed the retreats page as a bare <iframe> on its own. If you copy only the iframe (for example <iframe src="https://mangobeds.com/retreats/..."></iframe>), the page may still appear, but the widget features will not work: the iframe will not resize correctly on your page, and clicks on a retreat card will not open the retreat correctly. Always paste the full <script> widget code shown above.

Note: In some website builders like Wix, if the retreats page is not displayed, paste the widget code inside the page body, between the <body> tags. E.g. <body><script async data-property-id="PROPERTYID" src="https://mangobeds.com/js/widget/retreats.js"></script></body>

Retreat bookings consume the same inventory as direct bookings, so availability stays consistent across both channels. The same room can have a regular nightly rate AND a retreat-week total price at the same time, without any conflict.

Running the same retreat multiple times a year

If you run the same retreat four times a year (e.g. the same Nature Adventure Holiday in May, July, September and October), don’t fill the form four times. Open the 3-dot menu on the source retreat and click Clone. Pick the new dates and click Clone.

You can tweak anything afterwards by clicking the cloned retreat and editing.

Tips

  • Set the dates first when creating — if dates are already filled when you tick an accommodation, the retreat price field will prefill with the accommodation’s base nightly price × number of nights as a starting point. Bump it up from there to the retreat total.
  • Use one “Retreats” booking form for all your retreats unless they really need different extras / terms / payment behavior. Edit it once, every retreat picks up the change.
  • Custom guest questions are the cleanest way to capture dietary needs, experience level, emergency contacts or signed waivers — set them on the booking form and they show up on every retreat that uses that form.
  • The Disabled toggle is your “draft” mode — finish a retreat over a few days without it showing up on the public page until you’re ready.

Wrap-up

The Retreats app turns Mangobeds into a proper platform for selling packages: dedicated landing pages, per-accommodation retreat pricing, clone for recurring occurrences, and a built-in booking widget that flows through your existing payment provider. Set up one booking form, create as many retreats as your plan allows, and share the link.

You may also like