> ## Documentation Index
> Fetch the complete documentation index at: https://docs.supercycle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Date picker blocked dates

> Stop customers picking certain start or end dates on the storefront calendar without touching inventory

Date picker blocked dates are rules that stop customers selecting certain dates on the storefront calendar when they book a [calendar rental](/documentation/methods/calendar/overview). Use them for weekends, holidays, a booking window, or any date pattern you want to turn off in the picker. Manage them under **Online store** on <Icon icon="shopify" iconType="solid" /> **[Channels](https://admin.shopify.com/apps/supercycle/settings/channels)**.

<Note>
  These rules only affect which dates customers can pick on the online store. They don't remove inventory availability, hold units, or affect draft orders or existing cycles. To make products, variants, or items unavailable to book, use [blocked dates](/documentation/manage/inventory/blocked-dates). [Opening hours](/documentation/configuration/logistics/opening-hours) can also block pickup and drop-off dates when time selection is turned on.
</Note>

***

## Block types

Each rule uses one block type:

| Block type           | What it blocks                                             |
| -------------------- | ---------------------------------------------------------- |
| **Specific date**    | One calendar day                                           |
| **Date range**       | Every day from a start date through an end date, inclusive |
| **Before a date**    | Every date before the chosen day                           |
| **After a date**     | Every date after the chosen day                            |
| **Days of the week** | Recurring weekdays, for example every Saturday and Sunday  |

Add an optional **Description** so you can tell rules apart in the table, for example `Christmas break` or `No Sunday starts`.

***

## Start and end dates

Every rule also has an **Applies to** setting with three values:

| Setting                 | Effect                                                               |
| ----------------------- | -------------------------------------------------------------------- |
| **Start and end dates** | Blocks the matched dates on both the start picker and the end picker |
| **Start dates only**    | Blocks the dates only when the customer picks a start date           |
| **End dates only**      | Blocks the dates only when the customer picks an end date            |

Use separate rules when start and end restrictions differ, for example to block Sunday starts but still let a rental end on a Sunday.

***

## Manage date picker blocked dates

<Steps>
  <Step title="Open Online store settings">
    Go to <Icon icon="shopify" iconType="solid" /> **[Channels](https://admin.shopify.com/apps/supercycle/settings/channels)** and open **Online store**.
  </Step>

  <Step title="Review existing rules">
    The **Date picker blocked dates** table lists every active rule with its summary, what it applies to, and your description. Select a row to edit it.
  </Step>

  <Step title="Add a rule">
    Select **Add dates**. Choose the **Block type**, enter the dates or days, set **Applies to**, and add a description if it helps. Select **Save**.
  </Step>

  <Step title="Edit or delete a rule">
    Select a row to change it, or select **Delete** in the modal footer to remove it. Changes apply to the storefront calendar immediately.
  </Step>
</Steps>

Rules are store-wide. They apply wherever the Methods app block shows a calendar date picker on the online store.

***

## Examples

* **Block weekend starts and ends.** One rule: **Days of the week**, Saturday and Sunday, **Start and end dates**.
* **Block bookings more than 6 weeks out.** One rule: **After a date**, the day 6 weeks from today, **Start and end dates**. Edit the date from time to time, or use the theme JSON below for a rolling window.
* **Block Christmas week for starts only.** One rule: **Date range**, December 24 through January 2, **Start dates only**.

***

## Theme block JSON <Badge color="gray" size="sm">Deprecated</Badge>

Before this setting existed, you entered [DayPicker matcher JSON](/developers/app-blocks/methods#legacy-theme-json-matchers-deprecated) in the Methods app block's **Unavailable start dates** and **Unavailable end dates** theme settings. That JSON still works and stacks with admin rules, but the fields are deprecated. Use **Date picker blocked dates** in the admin for new rules.

For a rolling booking window that updates every day without manual edits, you can still set `window.supercycleDisabledMatchers` in theme code. See [Legacy theme JSON matchers](/developers/app-blocks/methods#legacy-theme-json-matchers-deprecated).
