# Sales Blocks ## Overview A sales block lets you say "stop selling this, for this period." It was built for facilities where several plans share the same room type (with only 1 unit of inventory) and an owner needs to close just one plan on a specific date — for example, blocking Personal Training only on a day the trainer is out, while Rental keeps selling unattended. Day-of-week rules can only close a plan on a recurring cycle; there was previously no way to close a plan on a specific date. > **This feature is enabled per facility.** If the Special Dates tab does not appear in Settings, the `ui_settings_date_tab` feature flag is off for that facility. Ask support to enable it. --- ## Where to find it **Settings → the "Special Dates" tab → "Sales Blocks"** (at the top of the tab). Facility Owners and Organization Owners can edit it (facility members can view only). You can also add, edit and delete the same sales blocks from the reservation calendar (see below). --- ## Key Features - Add, edit and delete sales blocks per plan - Cover a single day or a date range (up to 366 days) - An optional internal-only note (reason) - Ended sales blocks are hidden from the list by default, with a toggle to show them - A "Sales Block" band on the reservation calendar's month and week views (including past dates) - Add, edit and delete directly from the calendar --- ## What You Can Target (Current Scope) **Right now, a plan is the only thing you can target.** Rooms, room types and the whole facility are planned for later, but **they do not appear as options yet** — a deliberate choice, so an owner cannot pick an option that looks like it closes the facility but silently does nothing. **Inventory (the room type's remaining unit count) does not change.** A sales block only stops sales for that one plan, so other plans sharing the same room type keep selling as normal. This is intentional. To close an entire facility for a date, you currently need to add a sales block to every affected plan individually. --- ## Adding a Sales Block 1. Open **Settings → the "Special Dates" tab** 2. Click "Add sales block" in the Sales Blocks section 3. Fill in the following | Field | Description | Required | |---|---|---| | Target type | Currently only "Plan" can be selected | Yes | | Target | Choose the plan to block. Disabled plans are shown with a "(Disabled)" label. If the facility has only one plan, it is selected automatically | Yes | | Start date | The first day of the block | Yes | | Single day | ON by default; while ON, the block ends on the same day it starts and the end date field is hidden | - | | End date | Shown once "Single day" is turned off. Must be on or after the start date | Required when Single day is off | | Reason | For example "Trainer unavailable." **An internal note only — guests never see it on the booking site.** 200 characters max | No | 4. Saving stops sales for that target during that period --- ## Where It Applies (Important) A sales block applies to: - Guest online bookings - Front desk bookings made on a guest's behalf - Changing a booking's date/time - Extending a booking - **Walk-in check-ins (checking in on the spot, same day)** A sales block does **not** apply to: - **Existing bookings are not cancelled.** Reservations already on the books stay exactly as they are once a sales block is added - **Guests with an existing booking can still check in as normal.** For example, if a guest booked Wednesday on Monday, and you add a sales block for Wednesday on Tuesday, that guest can still check in without issue on Wednesday. This is by design --- ## How the List Looks - Each sales block in the "Special Dates" tab list shows its period as a "Single day" or "N days" badge - **Ended sales blocks (past their end date) are hidden from the list by default.** Click "Show ended sales blocks (N)" to reveal them — the record is kept so you can trace who blocked what, and when - If the list grows very large, only some entries are shown and you are prompted to remove ones you no longer need --- ## Managing Sales Blocks from the Calendar The reservation calendar's month and week views show each sales block's period as a **"Sales Block" band**. - **It also appears on past dates**, so you can later answer "why didn't we get bookings last Wednesday?" - The band shows the target, the period and the reason - Multiple sales blocks on the same day collapse into a summary like "Sales Blocks: 2"; opening it lets you choose which one to edit - **You can add, edit and delete sales blocks directly from the calendar.** Opening the editor from the calendar pre-fills the date - The Settings page and the calendar save through the same path, so editing from either place produces the same result - **Viewing is available to facility members too** (front desk staff often need to know why a date has no bookings). **Adding, editing and deleting require Facility Owner or above** — the buttons are hidden if you don't have that permission See [Reservation Calendar](reservation-calendar.md) for details. --- ## What Guests See - On the weekly grid in the booking flow, a blocked date is shown as **unselectable**. **No reason is shown** - If a guest tries to force a booking anyway, they see: "Reservations for this plan are not being accepted on the selected date. Please choose a different date." - If the system cannot confirm the sales block status, **the booking is rejected** and the guest sees "We're unable to check availability right now. Please try again shortly." This is a deliberate fail-safe: it is safer to briefly block a booking than to accidentally sell a date that was supposed to be closed --- ## Deleting a Sales Block Clicking "Delete" shows a confirmation: "This will remove the sales block for [target] on [period]. Sales for this period will resume." The record is kept internally for audit purposes even after deletion (it just disappears from the screen). --- ## Limitations - A single sales block covers **at most 366 days**. Split longer periods into multiple sales blocks - The end date must be on or after the start date - A plan is currently the only thing you can target (rooms, room types and the whole facility are not yet supported) --- ## FAQ ### Q: What happens to existing bookings when I add a sales block? A: They are not cancelled. A sales block only blocks new bookings, changes, extensions and walk-ins from that point on. ### Q: Can a guest with an existing booking still check in during a blocked period? A: Yes. Guests with an existing booking can check in as normal. A sales block only stops new bookings — it never blocks check-in for a reservation that already exists. ### Q: Does blocking one plan also block other plans that share the same room type? A: No. A sales block only stops sales for that one plan. Inventory (the room type's remaining unit count) is unchanged, so other plans sharing the same room type keep selling. ### Q: I want to close the whole facility for a day — how do I do that? A: A plan is currently the only thing you can target, so to close an entire facility you need to add a sales block to every affected plan individually. ### Q: Can guests see the reason I entered? A: No. The reason is an internal note only and is never shown on the booking site. Guests only see the standard "not accepting reservations" message. ### Q: Why don't I see the "Special Dates" tab? A: The `ui_settings_date_tab` feature flag is off for that facility. It has to be enabled per facility, so ask support to turn it on. ### Q: I need to block more than 366 days — what do I do? A: A single sales block covers at most 366 days. Split the period into multiple sales blocks. ### Q: Where can I see sales blocks that have ended? A: Click "Show ended sales blocks (N)" in the Sales Blocks list on the "Special Dates" tab. The record stays even after a block is deleted, so you can trace who blocked what and when. ### Q: Can I edit a sales block from the reservation calendar? A: Yes. Tap or click the "Sales Block" band on the calendar to open the editor with the date pre-filled — you only need to adjust the period. Editing from the calendar produces the same result as editing from Settings. ### Q: Who can add, edit and delete sales blocks? A: Facility Owners and Organization Owners. Facility members can only view them — the add/edit/delete buttons are hidden without that permission. --- ## Related Pages - [Special Dates & Seasons](date-classes.md) - Per-date pricing, on the same "Special Dates" tab - [Basic Settings](base-settings.md) - Currency, timezone, business hours and holiday settings - [Reservation Calendar](reservation-calendar.md) - Adding and editing sales blocks from the calendar - [Price Plan Settings](plan-form.md) - Configuring the plans a sales block can target --- Last updated: 2026-08-21 - Initial version (#2802 #2813)