What are Calendars?

A calendar view is used to display multiple records from your database in a Calendar viewable from your live app.

What do Calendars look like in the live app?

Calendars display multiple records from one of the objects in your database in a graphical calendar interface.

Calendars can be displayed in multiple formats, such as a month, week, or day views:

Clicking on a calendar event can display more details in a popup. Each record’s details can be linked to a child page to edit or view more details about that record:

Where do I access Calendars?

You can access your calendar by clicking on the page that contains your calendar in the Pages section of the Builder. The calendar view will have a calendar icon and label to the left of the calendar's name:

What do I need to use Calendars?

Only objects that have at least one Date/Time field will be available as an option to display records within a calendar view.

Manage Calendars

Add a Calendar

You can add a calendar to display records on any starter page in your pages by selecting the Calendar option from the Views Toolbar at the top of the page:

Select the object you want to display records from and click the "Add calendar" button:

Then you can select additional options to add links to view or edit each listed record in a new page. Last, click the "Add view" button:

You can add links to edit each record with a form or view more details about each record.

You'll also have options to display any connected records if the calendar object has any connections to other records.

New calendars will default to use the first date/time field as its source to display records in the calendar, the first short text field as the label by default, and the first six fields for displaying popup details.

Edit a Calendar

Click directly on a calendar in your pages to edit it:

The calendar will open in "edit" mode where you can use the menu on the left to edit different aspects of the calendar.

Delete a Calendar

To delete a calendar from your page, just click on the trashcan icon in the calendar view:

Warning: Please note that deleting a calendar view will also delete any link/child pages directly connected to it.

Copy/Move a Calendar

To copy your calendar, drag the original calendar from its page and drop it on a new page:

You can also copy calendars by clicking on the gear icon and selecting the Copy option:

Then select which page you want to copy the calendar to:

To move your calendar and rearrange your live app pages, click anywhere on the calendar view and drag it above or below other views present on the page:

This will determine where the view displays on your live app page:

Calendar Settings

Data Source

The Data Source section is used to control the records the calendar will display:

• Data: the calendar will display all the object's records by default. Use the data section to add rules to limit which records will be displayed.

• Limit: show all the available records or limit to a specific number.

Click here for more on working with the data source.

Calendar

The Calendar section is used to control how the calendar works with your object to display events:

Title & Description: optional copy you can display above the calendar to add any necessary instructions or explanation.

Display: Calendar or List. The Calendar option is the default choice here when using a typical graphical interface. The list option lets you display as rows of text but still lets you navigate by different ranges (days/weeks/months).

Starting Range: the calendar has options to display in multiple date ranges: by month, by week, and by day. The user will be able to change which range they display the calendar in. This selection sets the starting range.

Date Field: select a field that the calendar will use as the date to place each event on the calendar. This field must be Date/Time type.

Label Field: select a label field that the calendar will display along with the date on the calendar. Choose a title, name, or any other field that can easily identify the whole record.

Week Start: select if you want the week on your calendar to start on Sunday or Monday.

Exclude Weekends: check this option to remove weekends from the calendar.

Starting & Ending Time: limits the time range in week and day views.

Event Options: Event Options give the user options when clicking on a date/time on the calendar:

• Show Event Details: when activated, the user can click on each event to view more details about that event in a popup window. See the Event Details section below for formatting this popup.

• Allow Event Adding: when activated, the user can click on a day in the calendar to add a new event. The date field will default to the day that was clicked. See the Add Event Form section below for formatting this form.

• Allow Event Dragging: when activated, the user can drag an event and move it to change the date, time, and duration.

Feeds: Feeds give the user options to download feeds that include all the events the calendar is displaying:

• RSS: an RSS feed can be subscribed to and will automatically update events in an RSS feed reader. The feed will not work if it's meant to show records connected to the logged-in user, or similar.

• iCal: a downloadable format that can be used to import the current events into another calendar service.

  The iCal download/URL of your calendar events will include only the upcoming and previous six months of events, based on the date you download the events. The iCal format will also not update with new events automatically from your App to the secondary calendar.

  Knack Tip: You can sync Knack calendar events to a Google calendar by right-clicking the iCal download link (on your Live App calendar view) and selecting the "Copy Link Address" option. You can then paste that URL into the “Add by URL” option in the Other Calendars section of your Google Calendar.

  If you get an error, "We could not parse the calendar at the URL requested.", it likely is due to the file size of your iCal .ics file. Google recommends a file size of less than 1MB, so the number of records or other filters may need to be applied to keep the file size under that limit.

Event Colors: add rules to display events in different colors based on criteria you add.

Record Filters: filters give the user tools to further refine which records the calendar will show. You can add filters as options for the user to add, or as a menu.

User filters: enabling user filters presents options for a user to add any filters they'd like to the calendar. This will then display an "add filters" link above the calendar:

The calendar will update as soon as a filter is added. Multiple filters can be added as needed.

You can determine if the fields available to filter are limited to the calendar details or all the object fields. You can add preset filters that will initially filter the records.

Filter Menu: Enabling a filter menu will present links above the calendar the user can click that will filter the records based on the rules you create.

Event Details

If your calendar is configured to show more details about a record when you click on it in the calendar, you can manage that details pop up here. This follows the same model as the Details view:

Click here for more on managing details.

Add Event Form

If your calendar is configured to allow new records to be added when the calendar is clicked, you can manage the form inputs here. This follows the same model as the Form view.

Click here for more on managing form inputs.

Notes and Troubleshooting

• When using a Date / Time field with calendar options turned on, and the end date is set before the start date's value, the calendar will utilize the end date as the start date, and vice versa.