Skip to main content

​
Overview

The Calendar and Meetings blocks show a single record’s meetings on its detail page, the calendar events where that contact is the organizer or a participant. They are two views of the same data:
  • Calendar (custral.object.calendar): a month grid. Days with meetings are marked with a dot; selecting a day lists that day’s meetings below the grid. Month arrows page through time.
  • Meetings (custral.object.meetings): a compact list, split into Upcoming and Past, with each meeting’s time, attendee count, and a join shortcut.
Both bind to the open record automatically (no channel or query to configure) and pull live from your connected calendars, so a contact’s page shows the meetings you have with them without any manual logging.

​
Use cases

  • A Contact or Lead record: see every meeting you’ve had and have coming up with that person, at a glance.
  • A Company / Account record: the Meetings list as a full-width strip under the record’s details (the default Contact (CRM) layout does this).
  • A Deal: keep the negotiation’s meeting history next to the pipeline stage.
Pick Calendar when the month-at-a-glance shape matters (spotting cadence, gaps, or a specific date); pick Meetings for a dense agenda list.

​
How matching works

A meeting is shown on a record when the record’s email matches the meeting’s organizer or one of its participants (case-insensitive). The email is read from the record’s email-typed properties, so a record with no email address shows nothing, by design. The blocks only query the calendars you can access, the ones you’ve connected plus any shared with you (a connected calendar is private to its owner unless shared). So the meetings shown are always ones you’re allowed to see, and two teammates viewing the same record may see different meetings depending on their own calendar access.

​
Choosing which calendars

By default both blocks include every calendar you can access. To narrow it, open the calendar picker in the block header (top-right) and select one or more specific calendars. The choice is saved on the block. Clearing the selection returns to “all my calendars”. The picker only lists calendars you have access to.

​
Requirements

Both blocks need two things to show meetings:
  1. A calendar you can access. One you’ve connected, or one shared with you (see Calendar overview). With none, the block shows “Connect a calendar…”.
  2. An email on the record, an email-typed property with a value. Without one, the block shows “Add an email to this record…”.

​
Configuration parameters

The blocks render against the open record; the only saved setting is the optional calendar selection.

​
Adding the block

Open a record view in edit mode, choose + Add block, and pick Calendar or Meetings. The AI record-page designer can also place either block when you ask for a “calendar”, “meetings”, or “schedule” section.

​
Troubleshooting

​
See also