Calendar settings

The calendar settings atom can be used to configure how your event types interact with your calendars. This atom gives you the ability to select where to add events when you’re booked. Additionally, you can also select which calendars you want to check for conflicts to prevent double bookings. Below code snippet can be used to render the calendar settings button

import { CalendarSettings } from "@calcom/atoms";

export default function CalendarSettingsComponent() {
  return (
    <>
      <CalendarSettings />
    </>
  )
}

For a demonstration of the calendar settings atom, please refer to the video below.

Customizations can be done to the calendar settings atom via props and classnames. Below is a list of props that can be passed to the calendar settings atom

Name	Required	Description
classNames	No	To pass in custom classnames from outside for styling the atom

Along with the props, calendar settings atom accepts custom styles via the classNames prop. Below is a list of props that fall under this classNames prop.

Name	Description
calendarSettingsCustomClassnames	Adds styling to the entire calendar settings atom
destinationCalendarSettingsCustomClassnames	Adds styling only to the destination calendar container
selectedCalendarSettingsCustomClassnames	Adds styling only to the selected calendar container
selectedCalendarSettingsClassNames	An object for granular styling of selected calendars component (see detailed table below)
destinationCalendarSettingsClassNames	An object for granular styling of destination calendar component (see detailed table below)

selectedCalendarSettingsClassNames Object Structure

The selectedCalendarSettingsClassNames prop accepts an object with the following nested structure for granular styling of the selected calendars component:

Property Path	Description
`container`	Styles the main container of the selected calendars section
`header.container`	Styles the header container
`header.title`	Styles the header title
`header.description`	Styles the header description
`selectedCalendarsListClassNames.container`	Styles the container that holds all selected calendar items
`selectedCalendarsListClassNames.selectedCalendar.container`	Styles each individual calendar item container
`selectedCalendarsListClassNames.selectedCalendar.header.container`	Styles the header section of each calendar item
`selectedCalendarsListClassNames.selectedCalendar.header.title`	Styles the title of each calendar item
`selectedCalendarsListClassNames.selectedCalendar.header.description`	Styles the description of each calendar item
`selectedCalendarsListClassNames.selectedCalendar.body.container`	Styles the body section of each calendar item
`selectedCalendarsListClassNames.selectedCalendar.body.description`	Styles the body description of each calendar item
`noSelectedCalendarsMessage`	Styles the message shown when no calendars are connected

destinationCalendarSettingsClassNames Object Structure

The destinationCalendarSettingsClassNames prop accepts an object with the following nested structure for granular styling of the destination calendar component:

Property Path	Description
`container`	Styles the main container of the destination calendar section
`header.title`	Styles the header title text
`header.description`	Styles the header description text

Additionally, if you wish to select either the Destination Calendar or the Selected Calendar, we also provide atoms specifically designed for this purpose. 1. Destination calendar settings atom The destination calendar settings atom lets you can select which calendar you want to add events to when you’re booked. Below code snippet can be used to render the destination calendar settings atom.

import { DestinationCalendarSettings } from "@calcom/atoms";

export default function DestinationCalendars() {
  const loadingStatus = <>Loading...</>

  return (
    <>
      <DestinationCalendarSettings classNames="mx-5" statusLoader={loadingStatus} />
    </>
  )
}

This is how the destination calendar settings atom looks:

Customizations can be done to the destination calendar settings atom via props. Below is a list of props that can be passed to the calendar settings atom

Name	Required	Description
statusLoader	No	To pass in a custom component for the loading state
classNames	No	To pass in custom classnames from outside for styling the atom

2. Selected calendar settings atom The selected calendar settings atom lets you select which calendars you want to check for conflicts to prevent double bookings. Below code snippet can be used to render the selected calendar settings atom.

import { SelectedCalendarsSettings } from "@calcom/atoms";

export default function SelectedCalendars( props : SelectedCalendarsProps ) {
  return (
    <>
      <SelectedCalendarsSettings classNames="mx-5 mb-6" />
    </>
  )
}

This is how the selected calendar settings atom looks:

Customizations can be done to the destination calendar settings atom via props. Below is a list of props that can be passed to the calendar settings atom

Name	Required	Description
classNames	No	To pass in custom classnames from outside for styling the atom

Getting Started

Onboarding

Booking

Event Types

Availability

Calendars

Integrations

Utility

Guides

Hooks

selectedCalendarSettingsClassNames Object Structure

destinationCalendarSettingsClassNames Object Structure

​selectedCalendarSettingsClassNames Object Structure

​destinationCalendarSettingsClassNames Object Structure

selectedCalendarSettingsClassNames Object Structure

destinationCalendarSettingsClassNames Object Structure