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

# Dock Doors

> This guide explains **how to create, configure, and manage dock doors in Yardo**. Dock doors are the primary schedulable resource in the system and directly determine appointment availability and capacity.

Proper dock configuration is critical to accurate scheduling, conflict prevention, and operational visibility.

***

## What Is a Dock Door

A **Dock Door** represents a physical loading or unloading position at a location.

In Yardo, dock doors:

* Are scheduled independently
* Define where appointments can occur
* Enforce capacity and availability rules

All appointments are ultimately scheduled against a dock door.

***

## How to Add a Dock Door

Administrators can add dock doors to a location individually or in bulk.

### Add a Single Dock Door

**To create a dock door:**

1. Navigate to **Settings → Locations → Docks**
2. Click **Add new door**
3. Enter the door details
4. Click **Create door**

***

## Dock Door Fields

### Door Name

A human-readable identifier for the dock door (for example, `Door 1`, `Inbound A`, or `Dock 12`). This name appears throughout the scheduling UI and reports.

***

### Dock Type

Defines how the dock door can be used:

* **Inbound** – Receiving only
* **Outbound** – Shipping only
* **Both** – Supports inbound and outbound appointments

Dock type helps guide scheduling decisions and visibility.

***

### Zone

Zones allow grouping of dock doors within a location.

If zones are not configured, doors can remain **Unassigned**.

Zones are commonly used for:

* Physical layout grouping
* Operational separation (e.g. frozen vs dry)
* Future yard or equipment rules

***

### Slot Interval

Determines the default appointment duration for this specific dock door.

Options include:

* **Use location default** (inherits from location settings)
* A door-specific override (e.g. 30, 60, 120 minutes)

Door-level overrides are useful when certain docks consistently require longer or shorter processing times.

***

### Status

Controls whether the dock door is available for scheduling:

* **Active** – Door can accept appointments
* **Inactive** – Door is unavailable but retained for history and reporting

Inactive doors do not appear as available when scheduling new appointments.

***

## Editing a Dock Door

To edit an existing dock door:

1. Navigate to the dock door list
2. Click **Edit** next to the door
3. Update the desired fields
4. Click **Save door**

Changes take effect immediately and may impact future appointment availability.

***

## Equipment Requirements

Dock doors can have **equipment requirements** associated with them.

Equipment requirements define what equipment must be available for appointments scheduled at that door.

If no equipment requirements are set, appointments do not enforce equipment constraints.

***

## Door Capacity (by Time Window)

Yardo allows defining **maximum concurrent appointments** per dock door within fixed time windows.

### How Capacity Works

Capacity rules limit how many appointments can overlap within a given window, such as:

* 15 minutes
* 30 minutes
* 60 minutes

For example, a capacity of `4` for a `30-minute` window means no more than four appointments may overlap within any rolling 30-minute period.

### How to Set Capacity

1. Open the dock door details
2. Select a time window
3. Enter the maximum capacity
4. Click **Save capacity**

If no capacity is configured, the door defaults to a single concurrent appointment.

<Info>
  Capacity settings are enforced in real time during scheduling to prevent overbooking.
</Info>

***

## Bulk Import Dock Doors

For locations with many dock doors, Yardo supports bulk import via CSV or XLSX.

### How to Import Dock Doors

1. Navigate to **Docks → Import**
2. Download the CSV or XLSX template
3. Fill in dock door details
4. Upload the completed file
5. Review validation results
6. Confirm the import

<Warning>
  Bulk imports create new dock doors and cannot be automatically undone.
</Warning>

***

## Best Practices

* Use clear, consistent naming for dock doors
* Start with location-level slot intervals and override only when needed
* Use inactive status instead of deleting doors to preserve history
* Define capacity rules carefully to reflect real operational limits

***

## Summary

Dock doors define the true scheduling capacity of a location.

By correctly configuring dock types, slot intervals, capacity, and status, organizations ensure accurate availability, prevent overbooking, and maintain reliable operational data.
