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

# Events Intelligence: Plan Campaigns Around Fashion Events

> Browse AI-researched festivals, marketplace sales, and seasonal peaks with dated prep deadlines, then link each event directly to Catalog Planning.

Events Intelligence is an AI-powered calendar of upcoming fashion events relevant to your market. It covers state festivals, marketplace sale windows, seasonal peaks, shopping holidays, and brand launch moments. Events are researched by Gemini using grounded web search — this is not a static pre-loaded list. The data is refreshed on demand and the last research timestamp is shown at the top of the page.

Use the Events page to identify when your catalogs need to be ready, then plan generation schedules backward from each event's prep deadline. Every event that requires catalog work has a direct **Plan catalog** button that opens the New Catalog form pre-filled with the event's creative direction.

## Event data

Each event on the roadmap carries the following information:

| Field                      | Description                                                         |
| -------------------------- | ------------------------------------------------------------------- |
| **Name**                   | The event title, e.g., "Diwali 2025"                                |
| **Type**                   | `festival`, `marketplace_sale`, `seasonal`, `shopping`, or `launch` |
| **Date**                   | Start date of the event window (and end date if multi-day)          |
| **Prep deadline**          | The date by which your catalog generation should be complete        |
| **Days until event**       | Countdown from today to the event start                             |
| **Prep days left**         | Days remaining until the prep deadline                              |
| **Priority**               | `urgent` (red), `high` (amber), or `normal`/`low` (grey)            |
| **Campaign season**        | The themed campaign period this event belongs to                    |
| **Themes**                 | Visual and creative themes recommended for this event               |
| **Color palette**          | Suggested colors for the shoot                                      |
| **Mood**                   | Emotional or aesthetic tone for the campaign                        |
| **Marketplace**            | Relevant marketplaces such as Myntra, Amazon, Meesho                |
| **Region / States**        | States or regions where this event is significant                   |
| **Recommended categories** | Product types to prioritize for this event                          |

## Views

Switch between three views using the toggle in the top-right of the filter bar:

<CardGroup cols={3}>
  <Card title="Timeline" icon="rows">
    Chronological view grouped by month. Each month shows a divider with the event count. Best for planning across multiple months.
  </Card>

  <Card title="Cards" icon="grid-2">
    Card-based view showing each event as a tile with date, countdown, prep status, themes, and a Plan catalog button. Best for scanning upcoming priorities at a glance.
  </Card>

  <Card title="Table" icon="table">
    Dense spreadsheet layout with all event fields visible across columns. Best for comparing events or identifying all events for a specific state or marketplace.
  </Card>
</CardGroup>

Your last-used view is remembered between sessions.

## Filtering events

<CardGroup cols={2}>
  <Card title="Horizon" icon="calendar">
    Limit the view to the next 30, 60, or 90 days; 6 months; 12 months; all upcoming events; or past events.
  </Card>

  <Card title="Type" icon="tag">
    Filter to a single event type: Festival, Marketplace sale, Seasonal, Shopping, or Launch.
  </Card>
</CardGroup>

Additional filters for **State / region** and **Marketplace** appear once events with those attributes are loaded. Use the free-text **Search** box to match any part of an event name, type, campaign season, state, or marketplace.

Click **Reset** to clear all active filters at once.

## Urgency indicators

Events with a prep deadline within the next 14 days are surfaced in a dedicated **Prep due within two weeks** section above the main calendar. Each event in this section shows its prep status badge:

| Badge                | Meaning                                          |
| -------------------- | ------------------------------------------------ |
| **Overdue** (red)    | The prep deadline has already passed             |
| **Due now** (amber)  | 14 days or fewer remain before the prep deadline |
| **On track** (green) | More than 14 days remain                         |

<Tip>
  Each event shows a **prep deadline** — the date by which your catalog generation should be complete. Use **"Use event prep deadline"** when scheduling generation in Catalog Planning to hit this automatically.
</Tip>

## Refreshing event data

Planning Managers and Admins see an **Intelligence** toolbar below the filter bar. Use it to keep your roadmap current:

<Steps>
  <Step title="Refresh research">
    Click **Refresh research (Gemini)** to run a new Gemini-powered event research pass. Gemini uses grounded web search to fetch fresh, verified event data for your configured market. The result banner shows how many events were created and updated.
  </Step>

  <Step title="Seed the calendar">
    Click **Seed state & marketplace calendar** to populate dated entries for every Indian state festival and major marketplace sale window for the next 12 months. Run research after seeding to confirm exact dates with grounded sources.
  </Step>
</Steps>

The last research run timestamp — including whether it completed, failed, or is still running — is shown in the page description text.

## Linking to Catalog Planning

Every event has a **Plan catalog** button. Clicking it opens the New Catalog form in Catalog Planning with the following fields pre-filled from the event:

* Campaign season and scene direction
* Mood and creative themes
* Color palette
* Event dates and prep deadline
* Linked event ID for tracking

The new catalog is linked to the event, so you can track which catalog was created for which occasion.

## Adding events manually

Click **Add event** (available to all roles) to create a custom event not covered by automated research. You can specify:

* Event name and type
* Priority (`normal`, `high`, or `urgent`)
* Event date and planning lead days (used to calculate the prep deadline automatically)
* States/region and marketplaces
* A free-text description

The prep deadline is calculated as: event date minus planning lead days. The form previews the deadline date as you type.

## Exporting events

Click **Download Excel** to export the current filtered event list as an Excel workbook (`.xlsx`). The workbook contains two sheets:

* **Planning calendar** — one row per event with all fields, auto-filtered headers, and color-coded priority and prep-status columns
* **Month summary** — one row per month with totals for events, festivals, marketplace sales, urgent events, and the first prep deadline in the window

<Tip>
  You can also email the planning report directly to stakeholders. Click **Email report** (Planning Managers and Admins only) and enter recipient email addresses. The email includes the upcoming events in the current view and attaches the same Excel workbook.
</Tip>

## Viewing event details

Click any event name in the Timeline, Cards, or Table view to open a detail drawer. The drawer shows:

* Full event window, weekday, and countdown
* Prep deadline and planning lead days
* States, marketplaces, and product focus
* Confidence percentage and verification status
* Visual themes, color palette, and styling props
* Research source URLs (up to 6) for events with grounded data

A **Plan catalog for this event** button at the bottom of the drawer links directly to the pre-filled New Catalog form.