OptimoCMS Docs
Back to overview

Vacation rental

Everything about vacation rental: activation, property, calendar, pricing, bookings, iCal synchronisation, deposits, extras and rental agreements.

Activating vacation rental

To enable vacation rental: 1. Go to Settings → Widgets 2. Activate "Vacation Rental" 3. After activation, the rental admin pages appear in the side menu 4. The RentalBlock becomes available in the Page Builder
Tips
  • All widgets, including vacation rental, are available on every plan. The difference between plans is the number of websites.

Creating your property

After activation, create your property via Vacation Rental → Property: 1. Fill in the basics tab: name, description, type (house, apartment, villa, etc.) and status 2. Add the address on the Location tab — the system automatically looks up coordinates 3. Set features: maximum guests, bedrooms, beds, bathrooms and amenities 4. Upload photos on the Media tab, choose a hero image and set the order 5. Configure policies: check-in/check-out times, cancellation policy and house rules
Tips
  • The first photo in the list automatically becomes the hero image.
  • Use the SEO tab for a custom page title and description.

Basic settings

Via Vacation Rental → Settings you can configure: • Turnaround hours — time between two bookings (default 24 hours) • Minimum nights — default minimum stay • Instant booking — guests book without approval • Notification email — address for booking notifications • Service fee — optional platform percentage • Currency — default EUR

Calendar overview

The availability calendar is found under Vacation Rental → Calendar: • Green = available • Red = booked • Grey = manually blocked • Orange = turnaround day Navigate with the previous/next buttons or jump to today.

Blocking dates

Block dates for personal use or maintenance: 1. Click on a single day to block/unblock it 2. Drag over a date range for bulk blocking 3. Confirm in the dialog and optionally choose a reason Blocked dates are not bookable by guests.
Note
  • Dates with existing bookings cannot be blocked. Cancel the booking first.

Turnaround days

After each checkout, a turnaround period is automatically set (default 24 hours). During this period the property is not bookable. Adjust the turnaround hours via Vacation Rental → Settings.

Setting the base price

Upon activation, a base price rule is automatically created covering the entire year: 1. Go to Vacation Rental → Pricing 2. Click on the "Base Price" rule 3. Set the nightly rate 4. Optionally configure a minimum number of nights The base price has the lowest priority and cannot be deleted.
Tips
  • All amounts are stored internally in cents to avoid rounding errors.

Adding seasonal prices

Add higher rates for busy periods: 1. Click "New rule" 2. Enter a name (e.g. "High season summer") 3. Choose start and end date 4. Set the nightly rate, weekend surcharge and discounts 5. Set the priority — higher priority wins on overlap The system shows a warning for overlapping periods.
Tips
  • Weekly discount (7+ nights) and monthly discount (28+ nights) are calculated automatically.

Price breakdown for guests

Guests see a transparent price breakdown: • Nightly rate × number of nights • Weekend surcharge (Friday and Saturday) • Weekly or monthly discount • Cleaning fee (one-time) • Tourist tax (per person per night) • Optional: service fee • Total price

Bookings overview

Via Vacation Rental → Bookings you see all bookings: • Filter by status: upcoming, checked in, completed, cancelled • Sort by date or price • Click a booking for full details Each booking has a unique 6-character confirmation code.

Booking flow

A booking goes through these steps: 1. Guest selects dates and number of guests on the live site 2. System calculates the price server-side 3. With instant booking: guest pays via Stripe Checkout 4. With request mode: owner approves or declines 5. After payment: confirmation email to guest and owner 6. Check-in reminder 24 hours before arrival 7. After departure: thank you email and review request
Tips
  • Double bookings are impossible — the system checks availability in a Firestore transaction.

Cancellation and refund

For cancellation: 1. Open the booking and click "Cancel" 2. The blocked dates are automatically released 3. The guest receives a cancellation email 4. Refund is calculated based on the cancellation policy (flexible, moderate or strict) 5. Stripe refund is processed automatically

Guest CRM

Via Vacation Rental → Guests you manage guest profiles: • Search by name or email • View booking history per guest • Add notes Guests are automatically created with their first booking.

iCal export

Export your availability as an iCal feed for use in external platforms: 1. Go to Vacation Rental → Settings 2. Click "Generate iCal URL" under the export section 3. Copy the URL and paste it into Airbnb, Booking.com or another calendar The feed contains all bookings and blockings in RFC 5545 format.
Tips
  • The URL contains a secure token — do not share it publicly.
  • External platforms typically sync every 1-4 hours.

iCal import

Import availability from external platforms: 1. Go to Vacation Rental → Settings 2. Paste the iCal URL from Airbnb or Booking.com in the import field 3. Click "Sync now" for an initial sync Afterwards, synchronisation runs automatically every 30 minutes.
Note
  • Imported blockings never overwrite manual blockings or real bookings.

Synchronisation status

On the settings page you can see: • Last synchronisation time • Status: successful or error • Error message for unreachable URLs On errors, the system automatically retries at the next sync.

Deposit management

Set the deposit amount and manage the deposit per booking: 1. Go to Vacation Rental → Property → Policy tab 2. Enable the 'Require deposit' toggle 3. Enter the deposit amount (in cents, e.g. 25000 = €250) 4. Save — for new bookings, the deposit is automatically placed as a 'hold' on the guest's credit card 5. In the booking detail you'll find the 'Deposit' tab with the current status 6. Possible statuses: held, released, partially released, forfeited 7. After checkout, the deposit is automatically released after the configured number of days (default 7)
Tips
  • The deposit is only actually charged when deductions are added.
  • With 0 deductions, the hold is cancelled — the guest pays nothing extra.
  • The deposit amount can be changed at any time — this only affects new bookings.

Deposit deductions

Add deductions when there is damage or additional costs: 1. Open the booking and go to the 'Deposit' tab 2. Click 'Add deduction' 3. Choose a reason: energy costs, damage, extra cleaning or other 4. Add a description and amount 5. The balance overview shows: deposit − deductions = to be refunded 6. Click 'Release deposit' to refund the remainder
Note
  • Deductions cannot exceed the deposit amount.
  • After release, the deposit cannot be held again.

Booking extras

Guests can select extras when booking: 1. Go to Vacation Rental → Extras 2. Create extras with name, pricing type and category 3. Pricing types: per booking, per night, per person, or per person per night 4. Mark extras as required if they should always be included 5. Guests see the extras during the booking process on the live site The total amount including extras is calculated automatically.
Tips
  • Use categories (utilities, linens, services, equipment) to group extras clearly.

Rental agreement (contract)

The contract system automatically generates legally compliant rental agreements in accordance with European regulations: 1. Go to Vacation Rental → Agreements to manage templates 2. Use the built-in WYSIWYG editor or upload a Word document (.docx) with placeholders 3. Variables such as {verhuurder_naam}, {huurder_naam}, {check_in}, {totaalprijs}, {borg} are automatically filled 4. The default template contains 11 articles covering all legal requirements 5. When a booking is made, the contract is automatically generated in the CMS language 6. The guest receives an email with a link to sign digitally 7. After the guest signs, it's the owner's turn 8. After both signatures, a signed PDF is generated Available templates: Dutch, English, German, French and Spanish.
Tips
  • The default template is automatically loaded in the CMS language.
  • Unknown variables in Word uploads are flagged.
  • You can customise the template for local legislation via the WYSIWYG editor.

Digital signing

The signing process is fully digital: 1. The guest receives a secure link via email 2. After 24 and 48 hours, a reminder is sent if the guest hasn't signed 3. After 72 hours of inactivity, the contract automatically expires 4. The owner can generate a new contract if needed 5. In the admin panel you can see the status and signature previews of both parties
Note
  • Signing links are single-use and tied to one person. Do not share them.

Age policy

Configure which guests are welcome based on age: 1. Go to Vacation Rental → Property → Policy tab 2. In the "Age Policy" block you'll find two options: Adults only (18+) • Enable the toggle to exclude children and infants • The guest picker on the live site will only show the "Adults" field • Server-side validation blocks bookings with children or infants Minimum child age • Set a minimum age for children (e.g. 4 years) • Children below this age cannot be selected • The guest picker shows "Children (4–17 yrs)" and hides the infants field • Set to 0 or leave empty to welcome all ages (including infants)
Tips
  • This setting only applies to new bookings — existing bookings are not affected.
  • When adult-only is enabled, the minimum child age is automatically reset.

Call us