> ## 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 selecting certain start or end dates on the storefront calendar without changing inventory availability.

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 rolling booking window, or any date pattern you want to turn off in the picker.

<Note>
  These rules only affect **which dates customers can pick** on the online store. They do **not** remove inventory availability, hold units, or affect draft orders or existing cycles. To make specific products, variants, or items unavailable to book, use [Blocked dates](/documentation/manage/inventory/blocked-dates) instead. [Opening hours](/documentation/configuration/logistics/opening-hours) can also block pick-up and drop-off dates when time selection is enabled.
</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 strictly before the chosen day                   |
| **After a date**     | Every date strictly 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 vs end dates

Every rule also sets **Applies to**:

| Setting                 | Effect                                                                      |
| ----------------------- | --------------------------------------------------------------------------- |
| **Start and end dates** | Blocks the matched dates on both the rental start picker and the end picker |
| **Start dates only**    | Blocks only when customers choose a cycle **start** date                    |
| **End dates only**      | Blocks only when customers choose a cycle **end** date                      |

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

## Manage date picker blocks

<Steps>
  <Step title="Open Online store settings">
    From your Shopify admin, go to **Apps** → [Supercycle](https://admin.shopify.com/apps/supercycle/) → **Settings** → **Channels** → **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. Click a row to edit it.
  </Step>

  <Step title="Add a rule">
    Click **Add dates**. Choose the **Block type**, fill in the dates or days, set **Applies to**, and add a description if helpful. Click **Save**.
  </Step>

  <Step title="Edit or delete">
    Click a row to change the rule, or use **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 renders a calendar date picker on the online store.

## Examples

**Block weekend starts and ends**

Create one rule: **Days of the week** → Saturday and Sunday → **Start and end dates**.

**Block bookings more than six weeks out**

Create one rule: **After a date** → pick the cut-off day six weeks from today → **Start and end dates**. Edit the date periodically, or keep using the theme JSON escape hatch below for a rolling window.

**Block Christmas week for starts only**

Create one rule: **Date range** → 24 Dec through 2 Jan → **Start dates only**.

## Theme block JSON (legacy)

Before this admin UI, merchants entered [DayPicker matcher JSON](/developers/app-blocks/methods#legacy-theme-json-matchers) 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 those fields are deprecated and will be removed in a future release. Prefer **Date picker blocked dates** in the admin for new rules.

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