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

# Store Hours Configuration

> Set your operating hours and special schedules

Configure your store’s operating hours so your voice AI knows when you’re open and can provide accurate information to customers.

> [!WARNING]
>
> Store hours control your AI’s behavior and available capabilities. When the store is closed, certain features like call passthrough are automatically disabled.

## How Store Hours Work

Store hours determine what your AI can do and which tools it has access to. The AI’s capabilities change based on:

- Whether the store is currently open or closed
- Whether you have menus configured
- Whether menus are currently active (within menu hours)
- Whether ordering is enabled (pickup\_order or phone\_order)

> [!NOTE]
>
> You don’t need to include regular store hours in your knowledge base—the AI uses the configured store hours automatically. Enter holidays and one-off changes as **Special hours** (see below) so they override your regular hours for that date.

## AI Behavior Based on Store Status

When **pickup\_order** or **phone\_order** is enabled, your AI’s capabilities vary based on store and menu status:

### Store Open with Active Menus

- **Scenario**: Store has menus, is open, and menus are active
- **Capabilities**: Can answer detailed menu questions, take orders, answer questions from your knowledge base, share links, and transfer calls

### Store Open with Inactive Menus

- **Scenario**: Store has menus, is open, but menu hours have ended (menu hours end earlier than store hours)
- **Capabilities**: Can provide general menu recommendations, answer questions from your knowledge base, share links, and transfer calls

### Store Closed with Active Menus

- **Scenario**: Store has menus, is closed, but menus are still active (unrealistic configuration where menu hours extend beyond store hours)
- **Capabilities**: Can provide general menu recommendations, answer questions from your knowledge base, and share links
- **Note**: Call passthrough is disabled when store is closed

### Store Closed with Inactive Menus

- **Scenario**: Store has menus, is closed, and menus are inactive
- **Capabilities**: Can provide general menu recommendations, answer questions from your knowledge base, and share links

### Store Open, No Menus

- **Scenario**: Store has no menus configured, is open
- **Capabilities**: Can answer questions from your knowledge base, share links, and transfer calls (knowledge base-only mode)

### Store Closed, No Menus

- **Scenario**: Store has no menus configured, is closed
- **Capabilities**: Can answer questions from your knowledge base and share links (knowledge base-only mode)

## Setting Up Store Hours

### Navigate to Business Hours

1. Click **My Location** in the sidebar
2. Under **Quick Links**, click **Store Hours** (or open the location settings and choose the **Business Hours** tab)

You’ll see one row for each day of the week. A warning icon (⚠️) means no hours are set for that day, a red door means the store is closed, and a green check shows the day’s open and close times.

Click a day to expand it and edit its schedule inline, or use the **Open/Closed** switch on the right to change whether the store is open that day. To reuse a day’s hours, click **Copy**, select the other days under **Copy hours to**, and click **Apply**.

When you edit a day, set when your store opens and closes (your actual operating hours, not when you stop taking orders). Use **Open For Business** to mark days you’re closed.

![Setting up store hours for your location](https://docs.maple.inc/images/voice-core/store-hours-setup.gif)

Setting up store hours for your location

**Hour Gaps** are for split shifts or breaks during the day (e.g., closing between lunch and dinner service). Click **Add Hour Gap** to add a break period with start and end times.

![Example of setting up hour gaps for split shifts](https://docs.maple.inc/images/voice-core/setup-hour-gap.gif)

Example of setting up hour gaps for split shifts (e.g., closed between lunch and dinner)

Once you’ve configured the day, click **Save Store Hours**. The day’s row updates to show the times, plus any breaks.

![Store hours table with configured days showing times](https://docs.maple.inc/images/voice-core/configured-hours.png)

Store hours table with configured day showing times

### Special hours

Use **Special hours** for holidays and special occasions. They override your regular hours for the date you choose. Click **Add**, then enter the **Date** and an optional **Name** (for example, “Christmas Day”). New special hours default to **Closed all day**; to open with custom hours instead, switch off the closed toggle and enter the **Opens** and **Closes** times. You can also add an optional **Reason** (for example, “Holiday closure” or “Early closing”).

## Best Practices

**Store Hours vs Menu Hours**

- Set your actual closing time in store hours
- Use menu availability times to indicate last call for orders
- The AI’s capabilities automatically adjust based on these settings

**Split Shifts**

- Use hour gaps for lunch/dinner restaurants
- Example: Open 11 AM - 2 PM (lunch), gap from 2 PM - 5 PM, reopen 5 PM - 9 PM (dinner)

**Knowledge Base Management**

- Remove regular store hours from your knowledge base (no longer needed)
- Add holidays and one-off schedule changes as **Special hours** instead of knowledge base entries
- The AI automatically uses configured store hours and special hours

**Consistent Updates**

- Update store hours before holidays or special events
- Keep them in sync with your actual operating schedule
- Review weekly to ensure accuracy

## Next Steps

- [Configure Knowledge Base](https://docs.maple.inc/voice-core/knowledge-base.md): Add knowledge base content
- [Voice Settings](https://docs.maple.inc/voice-core/voice-configuration.md): Customize AI voice