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

# Calendar groups

> Combine multiple calendars into a single booking page using calendar groups in HoopAI.

Calendar groups bundle multiple calendars into a single shared booking page, giving contacts one link to browse all available options. This is ideal for teams, multi-service businesses, and multi-location operations where contacts should be able to choose from several calendars in one view.

## When to use calendar groups

| Scenario                   | How groups help                                                                 |
| -------------------------- | ------------------------------------------------------------------------------- |
| **Multi-service business** | Display all service calendars (consultation, follow-up, workshop) on one page   |
| **Multi-location**         | Show calendars for each office location in a single view                        |
| **Team booking**           | Let contacts browse all team members' calendars and pick their preferred person |
| **Department routing**     | Group calendars by department (sales, support, onboarding)                      |

## Creating a calendar group

<Steps>
  <Step title="Open Calendar Settings">
    Navigate to **Calendars > Calendar Settings** and click the **Groups** tab.
  </Step>

  <Step title="Create a new group">
    Click **+ New Group**. Enter a group name, URL slug, and optional description. Click **Create**.
  </Step>

  <Step title="Add calendars to the group">
    From the calendar list, click the three-dot menu next to each calendar you want to include. Select **Move to Group** and choose the group you created.
  </Step>
</Steps>

<Note>
  Each calendar can only belong to one group at a time. Moving a calendar to a new group removes it from its current group.
</Note>

## Group booking page

Once a group is created with at least one calendar, it has its own shareable booking page. The group booking page displays:

* All calendars in the group as selectable options
* Each calendar's name, description, and duration
* Available time slots for the selected calendar

Contacts browse the list, pick a calendar, and complete the booking — all from a single URL.

### Sharing the group link

Copy the group booking link from the Groups tab in Calendar Settings. Share it via email signatures, SMS, websites, or social media.

### Embedding the group page

Calendar groups have their own embeddable booking pages. From the group's action menu, select **Copy embed code** to get the iframe snippet. Paste it into your website HTML.

## Finding the group calendar ID

If you need the group calendar ID for API calls or workflow actions:

1. Open the group in Calendar Settings
2. Click the three-dot menu next to the group name
3. Select **Copy Calendar Group ID**

## Neo group view template

When using the **Neo** widget style, calendar groups display in a modern card layout. Each calendar in the group appears as a card with its name, description, duration, and a **Book** button. Contacts tap a card to view available slots.

To switch to Neo style, go to **Calendar Settings > Advanced Settings > Customizations** and select **Neo** as the widget style.

## Deactivating groups

To deactivate all calendars in a group at once:

1. Open the **Groups** tab in Calendar Settings
2. Click the three-dot menu next to the group
3. Select **Deactivate all calendars in group**

This stops all calendars in the group from accepting new bookings. Existing appointments are not affected. To reactivate, toggle individual calendars back to active.

To delete a group entirely, remove all calendars from it first, then delete the empty group from the Groups tab.

## Use cases

<AccordionGroup>
  <Accordion title="Multi-location business">
    Create a group with one calendar per location. Contacts see all locations on one page and book at the most convenient one. Include the address in each calendar's description for clarity.
  </Accordion>

  <Accordion title="Service menu">
    Group all service-type calendars (e.g., haircut, color, blowout) into one booking page. Contacts pick the service they want and see available times for that specific service.
  </Accordion>

  <Accordion title="Team directory">
    Add each team member's individual calendar to a group. Contacts browse the team, read bios in the calendar descriptions, and book with their preferred person.
  </Accordion>
</AccordionGroup>

<Tip>
  Customize each calendar's cover image and description before adding it to a group. These details appear on the group booking page and help contacts make informed choices.
</Tip>
