Skip to main content
This is now deprecated and under maintenance for existing users only - no new customers can sign up for the platform plan
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

NameRequiredDescription
classNamesNoTo 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.

NameDescription
calendarSettingsCustomClassnamesAdds styling to the entire calendar settings atom
destinationCalendarSettingsCustomClassnamesAdds styling only to the destination calendar container
selectedCalendarSettingsCustomClassnamesAdds styling only to the selected calendar container
selectedCalendarSettingsClassNamesAn object for granular styling of selected calendars component (see detailed table below)
destinationCalendarSettingsClassNamesAn 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 PathDescription
containerStyles the main container of the selected calendars section
header.containerStyles the header container
header.titleStyles the header title
header.descriptionStyles the header description
selectedCalendarsListClassNames.containerStyles the container that holds all selected calendar items
selectedCalendarsListClassNames.selectedCalendar.containerStyles each individual calendar item container
selectedCalendarsListClassNames.selectedCalendar.header.containerStyles the header section of each calendar item
selectedCalendarsListClassNames.selectedCalendar.header.titleStyles the title of each calendar item
selectedCalendarsListClassNames.selectedCalendar.header.descriptionStyles the description of each calendar item
selectedCalendarsListClassNames.selectedCalendar.body.containerStyles the body section of each calendar item
selectedCalendarsListClassNames.selectedCalendar.body.descriptionStyles the body description of each calendar item
noSelectedCalendarsMessageStyles 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 PathDescription
containerStyles the main container of the destination calendar section
header.titleStyles the header title text
header.descriptionStyles 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

NameRequiredDescription
statusLoaderNoTo pass in a custom component for the loading state
classNamesNoTo 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

NameRequiredDescription
classNamesNoTo pass in custom classnames from outside for styling the atom

Previous: List Schedules

Display schedules

Next: Calendar View

Calendar display