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

# Markdown calendars

> Define the windows when markdowns are allowed and the discount limits that apply.

A **markdown calendar** defines the periods during which markdowns are permitted — for
example *Black Friday, 2026-11-20 → 2026-11-30*. Rules use the calendar to control when
[markdown plan](/en/inventory-plans/markdown) items can be added and what discounts apply.

## What it controls

* **Active window** — whether a proposed markdown date falls inside an allowed period.
* **Discount limits** — caps such as a maximum discount per window or a minimum margin
  after discount.
* **Frequency** — guards like how recently a variant was already marked down.

A window is typically in one of these states: **upcoming**, **active**, or **completed**.

## Working with markdown calendars

<Steps>
  <Step title="Open markdown calendars">
    Go to **Intelligence layer → Markdown calendars**.
  </Step>

  <Step title="Define windows">
    Add the allowed markdown periods (name, start, end).
  </Step>

  <Step title="Attach rules">
    Add markdown-calendar rules (active-window, max discount, min margin) to the ruleset
    used by your markdown plans.
  </Step>
</Steps>

<Note>
  Markdown plans don't use the approval workflow; the calendar and its rules are the main
  guard rails. See [Markdown plans](/en/inventory-plans/markdown).
</Note>