# Schedule and class blocks

> Schedule blocks in the editor: Live class, day chips, timetable, date cards, countdown banner, upcoming dates, group tabs and Refer a friend.

Source: https://docs.personacart.com/editor/blocks/schedule-blocks

In short: {"Schedule blocks in the editor: Live class, day chips, timetable, date cards, countdown banner, upcoming dates, group tabs and Refer a friend."}

If you run classes, clinics or camps, these blocks show your **real, live schedule** on a page. They never carry typed times: they read the class schedule you keep in the app, so the page is always right when you move or cancel a session.

1. Open a page in the editor, hover inside a section and press **Add**.
2. Choose **Component** and pick the block.
3. Click it on the canvas and change its settings in the inspector on the right.

## Where to find it

Open a page in the editor (Sidebar → STOREFRONT → Pages), then:

- Press **Add**, then **Section**, and use the **Schedule widgets** filter chip.
- It gives ready-made schedule sections.
- Individual pieces are under **Component → Coach tools** (search "schedule", "week" or "choice").
- You can also add a live piece from a section's menu: **Live: This week (day chips)**, **Live: This week (session line)**, **Live: Next class line (starts in…)**, **Live class piece**, **Live class: Directions** and **Live class: Add to calendar**.
- **Stop live week** and **Stop live class** turn a piece back into plain text.
- See [Add a section or a block](/editor/add-section-and-templates).

## Live class (the full widget)

**Live class** is the complete schedule widget. When you add it, the editor shows **Set up your class schedule**: pick a schedule (or create one here), optionally pick the product people buy, then **Done**.

| Setting | What it does |
| --- | --- |
| **Schedules** | The class schedules to show. Make one here or on Commerce → Schedules. Each shows **On store** or **Not on store**. |
| **Product people buy (optional)** | The product a buyer purchases to join. |
| **Groups** | **All groups** or **Only these groups** (pick a schedule first). |
| **Several groups** | **Tabs** or **Side by side**. |
| **Layout** | **Tonight + week**, **Week timetable**, **Next-session strip**, **Agenda**, **Group cards**, **Month calendar**, **Week columns**, **Session cards**, **Day strip** or **Tonight spotlight**. |
| **Buttons** | Up to a few buttons, each doing one of **Directions**, **Add to calendar** (**What gets added**: **Let the visitor choose**, **Only this class** or **Every week**), **Product (buy / join)** or **Link**, with **Main** or **Secondary** style. |
| **Note** | A line such as "Same schedule all year". |

On the canvas the widget shows an example ("Example schedule — only you see this.") until a real schedule is picked, and tells you if the schedule is not published, is off, or has no groups yet.

## The pieces

Each of these reads the live schedule. They can be combined in one section and follow the same picked group.

| Block | What it shows |
| --- | --- |
| **Day chips** | Seven chips (SUN to SAT): class days filled, NEXT highlighted, TODAY, LIVE and CLOSED badges. Tap a day for its times. |
| **Status line** | One live line: "Today 6:30 PM · starts in 50 min", "Live now · ends in 45 min", or "Next: Sunday 3 PM · in 2 days". |
| **Week line** | A one-line summary of the week's sessions. |
| **Upcoming dates** | The next few class dates and times as a list; closed or moved sessions show their reason. |
| **Group tabs** | Tabs for the schedule's groups (for example Grades 5-8 and 8-12); every schedule piece in the same section follows the picked group. |
| **Info line** | Facts under a schedule: place (opens Google Maps), directions, groups, session length. |
| **Timetable** | A week grid: one row per group, one column per day, today tinted, the NEXT cell highlighted; one row per day on phones. |
| **Date cards** | Cards for the next 7 or 14 real dates (swipe sideways), each with that day's sessions for every group; closed dates struck with the reason. |
| **Countdown banner** | A big NEXT CLASS banner: day, time, place, a live countdown and the week's days; LIVE NOW while the class runs. |

Settings you will find on these pieces, where they apply:

- **Schedule**, **Group** (**All groups** or one), **Week starts on** (**Visitor's usual day**, **Sunday** or **Monday**).
- **Show NEXT and LIVE** / **Show NEXT, LIVE and TODAY**, **Show times**, **Under each day** (**Start time**, **The word "Class"**, **Group**, **Nothing**, **Time and place**), **Day names** (**Short (Mon)** or **Full (Monday)**).
- **Words before the times** (for example "Every week"), **Clock** (**Visitor's usual**, **12-hour**, **24-hour**), **Show the time-zone name**.
- **How many dates**, **How many days**, **Show closed dates**, **Show the week's days**, **Tab names** (**Full** or **Short**).
- **Info line items**: add, remove and reorder items; each has **Shows** (**Place**, **Directions**, **Groups**, **Session length**, **Your own text**), **Icon**, and **Link** (**Google Maps**, **Directions**, **Any link or page**, **No link**).
- **Text style** for each part (day, date, time, badge, status, reason, tab and so on).

Each block's **Schedule** source is either a chosen **Schedule** or **None — use a product** (then it follows the product's schedule). Until one is picked the block says "Choose a schedule — this is an example" and shows sample data only you see.

## Choices: let visitors pick a grade or a place

A **Choice** lets a visitor pick one thing, such as a grade or a place, and parts of the page change to match.

  Open the page's settings and find Choices. Press Add a choice, name it (for example "Grade") and add Options ("Grades 4 – 8", "Grades 8 – 12"). The filled dot marks the option shown first.
  Add a Choice picker block. In the inspector pick the Choice. Look: Big buttons, Wide buttons, Pills or Dropdown. Also Height, Width (Fill the column or Just fit the words), Position and an optional Label such as "Pick your grade".
  On any element, open Changes with a choice and choose which choice it changes with. A table lets you set different Text, Link, Photo, Photo description, Note next to the price, Small line above the title or Button text for each option; an empty box uses the normal one.
  On a schedule piece, turn on Follow choice so it shows the class times that match the visitor's pick. By default an option is matched to the group with the same name (Match by name).

Deleting a choice or an option tells you how many elements use it ("Their settings for it will be removed too") and offers **Keep it**.

## Refer a friend

- Shows your refer-a-friend offer on a page.
- It reads your program, so the editor tells you whether it is **ON** (friends get the reward you set) or **OFF** ("Buyers do not see this section"), with **Change in Refer a friend** and **Turn it on in Refer a friend**.
- See [Refer a friend](/commerce/refer-a-friend).

| Setting | What it does |
| --- | --- |
| **Layout** | **Centered**, **Beside a picture**, **Give and get**, **Three steps** or **Ladder** (a sample shows until a buyer signs in). |
| **Show reward amounts** | Whether the amounts appear. |
| **Picture** and its description | For the **Beside a picture** layout. |
| **Heading**, **Text** (lines you add or remove), **Reward line** | The words. |
| **Buttons** | **The buyer's own share link** or **Your Refer a friend page**, with **Main** or **Plain** style. |

## What happens, and what doesn't

- Times, groups and dates come from your schedule. You edit them there, never on the page.
- If you pick a schedule that is off or not yet published, the block shows nothing to visitors and tells you why on the canvas.
- Visitors see times in their own clock style unless you choose a 12-hour or 24-hour clock.
- Pieces in the same section follow one group, so the day chips, status line and timetable always agree.

## Questions
