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

# Schedule

> The team calendar and My schedule: views, colors, site assessments and who sees what.

Schedule (`/schedule`) shows everyone's appointments in one calendar. The subtitle reads **"Macro calendar across every assignee. Filter by door expert or appointment type. Click any event to open the opportunity."** The same subtitle shows for every role and view.

## Views

Pick **Day**, **3-day** or **Week** in the view switch, or **Month** or **List** right next to it. On a computer, Schedule opens on **Week**. On a phone, it opens on **Day**.

* **3-day** shows three days side by side, starting with the day you're on. The previous and next arrows move three days at a time, and **Today** puts today in the left column. Three days with nothing booked read **"No appointments these three days"**.
* **Day** shows one day, and **Week** shows Monday through Sunday.
* Click a day's date at the top of **Week** or **3-day** to open that day in **Day**. If you can book site assessments and have a job picked in the [Needs site assessment](#needs-site-assessment-queue) list, it opens the [booking dialog](#use-the-booking-dialog-instead) on that day instead.

### Overlapping appointments

When appointments overlap in **Day**, **3-day** or **Week**, they sit side by side in equal-width columns instead of covering each other, so every card stays readable and clickable.

* **Day** and **3-day** show up to three overlapping appointments side by side. **Week** shows up to two.
* Any more are tucked into a dark **+N** chip next to the group (for example **+3**). On **Day** and **3-day**, the chip also shows the time span of the hidden appointments.
* Click the chip to open **Overlapping appointments**: a list with each hidden appointment's name, type, time and address. Click one to open it, the same as clicking its card. Close the list with the **X**, by clicking anywhere else, or with **Esc**.

## Reading the calendar

* Block types: **Sales consult**, **Site assessment**, **Install**, **Service** and **Warranty**. Repair visits show as **Service**.
* Each team member has their own color, and no two people on the schedule share one. The **Team** legend shows who is who, and the colors on appointment cards always match the legend.
* The **Team** legend always lists active installers, Door Experts and admins from every market, including people with nothing booked. PMs, dispatchers and managers aren't part of that list.
* The **Assignee** filter lists the team so you can show one person's appointments. QA and test accounts are left out of both the legend and the filter.
* Pick **Unassigned** in the Assignee filter (right under **All assignees**) to see only the appointments nobody is on yet. It isn't a person, so it never shows in the Team legend.
* **Hold** appointments stay on the calendar. Their card shows a small gray **Hold** label at the start of the top line, and the hover card and read-only popover show the same label next to the job type. The label is plain gray on purpose: Hold is a normal state, not an alert.
* A job with nobody assigned reads **Unassigned** where the first name would be (for example **Unassigned · Service**), and its left stripe is light gray instead of a person's color. The hover card and read-only popover say **Unassigned** too.
* A job can be both, in which case the card shows the **Hold** label and the word **Unassigned**.
* A visit with more than one installer shows the lead's name followed by **+1**, **+2** and so on for the helpers, in every view including **Month** and **List**. The hover card and the read-only popover list the whole crew, with **(lead)** after the lead's name. This works for installs and for site assessments with helpers. See [Add more installers](https://help.yournewdoor.com/guides/readiness-gates.md#add-more-installers).
* Canceled appointments are hidden. No-shows are shown struck through.
* An empty day shows **"No appointments on this day."**
* If loading fails you'll see **"Couldn't load appointments. Try again."**

> [!NOTE]
>
> Cards show the **Hold** label and the word **Unassigned**, and the Assignee filter has an **Unassigned** option. Hold and unassigned cards look the same for every role. The calendar shows holds created in Field Ops. Hold appointments from ServiceTitan don't show here. On the **Field map**, a Hold job shows as a regular scheduled job.

## Hover over an appointment

On a computer, hovering over an appointment opens a card with its details. The card stays open while you move your pointer from the appointment onto it, so you can click the buttons on it. This works in **Day**, **3-day**, **Week**, **Month** (including the extra appointments listed on a busy day) and **List**.

* **Open full customer** is at the bottom of the card when the appointment has a customer. It opens the customer page. Appointments with no customer don't show it.
* When the card shows **Reschedule** and **Remove** (on a [sales call](#past-sales-calls)), **Open full customer** sits below them.
* On an install, service or warranty visit, roles that can edit the schedule get an **Edit crew** link. It opens the job's crew so you can change the lead and helpers. See [Open the crew from Schedule](https://help.yournewdoor.com/guides/readiness-gates.md#open-the-crew-from-schedule).
* The card closes a moment after your pointer leaves both the appointment and the card, when you press **Esc**, or when a button opens another page.
* The card doesn't open while you drag an appointment or have the right-click menu open.

## Click an appointment

Clicking a job card opens the customer page (`/customers/[id]`). If the appointment has no customer, it opens the job (`/jobs/[id]`) instead.

### Sales calls open a panel on the right

Clicking an active **Sales consult** card, including a past one, opens the sales-call panel on the right side of the screen, the same size and place as the customer flyout. On a phone it fills the screen.

The panel shows the customer's name, the day and time, the appointment type, tags and notes, with these actions:

* **Reschedule** and **Remove**. See [Past sales calls](#past-sales-calls) for the rules.
* **Text**, which opens this customer's texts, if your role can text customers.
* **Open customer**, which opens the customer page.

Close the panel with the **X** in its top-right corner, or on a computer by clicking the calendar behind it.

## Past sales calls

A **Sales consult** whose start is already in the past, including one from weeks ago, can still be cleaned up from the board so old calls don't pile up.

On `/schedule` and `/my-schedule` (day, week, month, list, the hover popover, and the sales-call sheet):

* Past sales-call cards stay on the calendar for that day until you move or remove them.
* Use **Reschedule** to pick a new time (same rules as booking: 7:00 AM–8:00 PM CT, duration 30 / 45 / 60 / 90 minutes, new time can't be in the past). You can move it to any active Door Expert or admin in any market.
* Use **Remove** to soft-cancel it. The dialog asks **Cancel sales call?**; after you confirm, the card leaves the calendar. The booking row stays on file. **Keep sales call** leaves the card where it is.
* Appointments synced from ServiceTitan or Sales Ops stay read-only.
* **Reschedule** and **Remove** look the same for every role that can open the board.

The same actions are on **Bookings → Schedule** (`/bookings/schedule`) when you turn on **Show past**. See [Reschedule or cancel](https://help.yournewdoor.com/bookings/reschedule-or-cancel.md).

## Read-only view

If your role can't edit the schedule, a yellow banner reads **"Read-only view. Use the booking dialogs to create or move appointments."** Dragging, the edit dialog, the right-click menu and booking from the **Needs site assessment** queue are only for roles that can edit (dispatchers, managers, executives, admins and the Owner). Everyone who can open Schedule still sees the queue itself, with the same look as admins. If your role can book appointments, you still get a **Book** button in the header.

## Needs site assessment queue

The **Needs site assessment** list sits beside the calendar on Schedule. It shows customers who have said yes but don't have a site assessment on the calendar yet, and its header shows how many are **ready to assess**. To book one, drag its card onto an installer's time on the calendar.

* **It's open when you land on Schedule,** even when nobody is waiting. Click the arrow at the top to fold it into a narrow strip that reads **Needs SA** with the count, and click the strip to open it again.
* **On a phone,** the list is a panel along the bottom of the screen. Tap the arrow to show more of it.
* **Needs assessment** in the Bookings menu opens Schedule with the list open, even when you're already on Schedule. The menu item doesn't show a count.
* **Each card** shows the customer, the address, the amount and their Door Expert.
* **Repair jobs never show here,** because repairs don't need a site assessment. They go to **Pre-job** when they're sold. See [Change a job's type](https://help.yournewdoor.com/jobs/job-type.md) if a job is the wrong type.
* **The list stays current.** It refreshes when you come back to the Schedule tab and when someone starts an install job, so you don't need to reload the page.
* **When nobody is waiting,** it reads **"Nothing waiting for a site assessment"**.

> [!TIP]
>
> New to booking a sold customer? See [After a sale: book the site assessment](https://help.yournewdoor.com/guides/after-a-sale-site-assessment.md) for the whole flow, who you can send, and how they see the visit.

### When a job shows up in the queue

A job lands in the queue automatically as soon as either of these happens:

* **The customer accepts the estimate or proposal.** This happens right away, even before the \$99 reservation is paid.
* **The customer pays the \$99 reservation.**

Each customer gets one job. If a customer accepts and then pays the \$99 (or the other way around), both point to that same job, so you won't see the customer twice.

A job leaves the queue once its site assessment is booked, or when the job moves past site assessment, is completed or is cancelled.

> [!NOTE]
>
> Accepted estimates and paid \$99 reservations create the job on their own. Some customers who accepted or paid before November 3 may not be in the queue yet. If one is missing, book their site assessment from their customer page.

### Who sees it and who can book

Every role that can open Schedule sees the same queue with the same layout. Your role only changes what you can do in it:

* **Dispatchers, managers, executives, admins and the Owner** can pick a job and book or edit its site assessment.
* **Everyone else who can open Schedule** (for example CSRs and Door Experts) sees the queue read-only. You can see who's waiting, but you can't book or edit from it.

### Book a site assessment

Drag a job from the list onto an installer's time. The visit is booked right away for **30 minutes** from the time you drop it on, a confirmation names the customer, the installer and the time, and the job leaves the list.

**1. Switch to Day or Week**

You can drop a job in **Day** or **Week**. **Month** and **List** don't take drops; dropping there shows **"Switch to Day or Week to drop a job on a slot."**

**2. Drag the card onto a time**

* **Day** shows a column for each person, installers first. Drop the card on an installer's column at the hour you want. An installer who hasn't signed in yet has an **Invite pending** tag under their name.
* **Week** has no person columns. Drop the card on the day and hour, and a **Book with an installer** list opens. Each installer shows **Open** or **Booked** for that time, and booked installers can't be picked. Pick one to book.

**3. Check the calendar**

The visit shows as a **Site assessment** on the calendar. To change the time or the installer, open it and edit it, or drag it.

> [!TIP]
>
> You don't have to drag. Click a card to pick it, then click an open time on the calendar, or a day's date at the top of **Week** or **3-day**. That opens the [booking dialog](#use-the-booking-dialog-instead) on that day, with an arrival window already picked, so you choose the window and the assessor before anything is saved. Only a drop books right away.

#### On a phone

Tap a card in the list to pick it, then tap a time on the calendar. The booking dialog opens on that day with the arrival window for that time picked. Check the assessor and the window, then save.

#### Use the booking dialog instead

For a custom start and end, a specific arrival window or notes for the assessor, click a card to pick it, then click **Book** on that card. Clicking an open time or a day's date at the top of **Week** or **3-day** opens the same dialog on the day you clicked. If you came from a customer page (**Schedule → Site assessment**, or **Book site assessment** in the **+** menu), their job is already picked for you, even when the list is long. See [Schedule an appointment from the customer page](https://help.yournewdoor.com/customers/schedule-appointment.md).

**1. Pick an assessor**

When you click an open time in an installer's column in **Day**, that installer is already picked. On a phone, the person you're viewing is picked when they're an installer. Otherwise the dialog picks its usual default, and you can change it. Clicking in **Week** or **3-day** doesn't pick a person.

The list shows active installers from every market, and only installers. An installer who hasn't signed in yet has an **Invite pending** tag next to their name and **"No login yet — won't get notifications."** under it, and can still be picked. Anyone who isn't an installer, or a removed user, can't be saved. See [Pick who goes](https://help.yournewdoor.com/guides/after-a-sale-site-assessment.md#3-pick-who-goes).

**2. Pick a time**

From **Book**, the dialog opens on the next arrival window that hasn't started yet today in Central time. After the **3-5 PM** window has started, it opens on tomorrow at **9-11 AM**. From an open time, it opens on that day with the window that covers that time picked (a time before 9 AM picks **9-11 AM**). From a day's date, it opens on that day at **9-11 AM**, or on the next window that hasn't started when the day is today. The seven 2-hour arrival windows are the same ones installs use: **9-11 AM**, **10 AM-12 PM**, **11 AM-1 PM**, **12-2 PM**, **1-3 PM**, **2-4 PM** and **3-5 PM** CT. They're quick picks that fill in **Start** and **End** with a 30-minute visit at the start of the window. The hint under the picks reads **2-hour window · 30-minute assessment**. A site assessment booked in an older window, such as 8-10 AM, keeps that window when you edit it, and the hint under the picks ends in **Saved window kept (not in picker)**. Editing a site assessment keeps its length, even when it's longer than 30 minutes (for example 1:00 to 2:30 PM), unless you change **Start** or **End** or pick a different window. You can also set a custom **Date**, **Start** and **End**, including later today. Click **Date** to open a calendar inside the dialog and pick the day. The day you pick stays put, and past days can't be picked. Visits must be between **7:00 AM and 8:00 PM CT**, can't be in the past, must end after they start, and must be **under 4 hours**.

**3. Handle conflicts**

If the time overlaps something else, you'll get a soft warning. Choose **Save anyway** to keep it.

#### Only installers

Site assessments are booked with installers only, whether you drop, click or use the dialog. Dropping a job on anyone else's column is refused.

#### Messages you may see

| What you see | What it means |
| - | - |
| **"Site assessments can only be booked with an installer."** | You dropped the job on someone who isn't an installer. Drop it on an installer's column instead. |
| **"That slot is already booked."** | The installer already has something at that time. Pick another time or installer. |
| **"Switch to Day or Week to drop a job on a slot."** | You dropped the job on **Month** or **List**. Switch views and drop it again. |
| **"Pick a job first"** | You clicked an open time before picking a job. Click the job's card, then try again. |
| **"This job isn't in Needs SA (already booked or not loaded)"** | You came from a customer, but their job isn't waiting for a site assessment. It may already be booked. Nothing is picked, so check the customer page before you book. |
| A soft warning with **Save anyway** | The time overlaps something else on that installer's calendar. Choose **Save anyway** to keep it. |

The same time limits apply to drops as to the dialog: between **7:00 AM and 8:00 PM CT**, and not in the past.

Booking from the list is for site assessments only.

## My schedule

My schedule uses the same calendar and job cards as the team Schedule. Your role changes what you can open and do, never how the cards look. An installer's My schedule includes jobs where they're a helper on the crew, not only the ones they lead.

**Bookings → My schedule** (`/my-schedule`) shows only your own appointments: the sales consults, site assessments, installs and service visits assigned to you. It's the place to check your week if you don't use the team Schedule (Design Concierges and PMs, for example, don't see `/schedule`).

* The header, colors, filters and read-only banner work the same as on the team Schedule.
* Switch between **Day**, **3-day**, **Week**, **Month** and **List**, with the same side-by-side [overlapping appointments](#overlapping-appointments) as the team Schedule.
* It opens on the current week in [your profile timezone](https://help.yournewdoor.com/guides/your-profile.md#set-your-timezone) (Central if you haven't picked one). Use the previous, next and **Today** buttons to move around; moving into another week loads that week's appointments.
* Clicking a card opens the customer page, or the job when there's no customer, just like the team Schedule.
* Canceled appointments and demo customers are left out.
* Anyone else's appointments never show here, even for office roles.

> [!NOTE]
>
> An appointment you book for yourself shows up on My schedule as soon as it's saved. If something you booked is missing, make sure you're looking at the right week and that it's assigned to you.

> [!NOTE]
>
> Clicking a card no longer opens a slide-in customer panel. To start an estimate for the customer you're meeting, click the card to open the customer page and use **Create estimate** at the top right.

## Who sees what

| Role | What they see |
| - | - |
| Admin, Owner, manager, executive, dispatcher | Whole team on Schedule; can drag, edit and book site assessments from the Needs site assessment queue |
| CSR, Door Expert | Whole team on Schedule, read-only; sees the Needs site assessment queue but can't book from it; Book button if they can book |
| Design Concierge, PM | Not the team Schedule; My schedule shows their own appointments on the same job cards, read-only, with a Book button if they can book |
| Installer | Sent to the Field view instead of the schedule |

Every role sees the same job cards. Roles only change access.

> [!NOTE]
>
> Door Experts can open the team Schedule. They get **Schedule** in the desktop menu and under **More** on mobile, and **Appointments today** on the desk and the Home shortcuts open `/schedule`. They see the same week grid, cards and popovers as admins, with the yellow read-only banner: no dragging and no edit dialog. They also see the **Needs site assessment** queue, read-only. Dispatch stays hidden for Door Experts; the [Field map](https://help.yournewdoor.com/guides/dispatch-map.md#field-map-for-door-experts) is open to them.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.