---
description: >-
  There is no way getting around filling these out.  Note that all Required and
  Optional Event Input Fields must be the same length so that corresponding
  event data is grouped together appropriately.
---

# Required Information

## Required Fields

![](https://1857871955-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MdYYYaX6u6mOCBpjLIC%2F-Mi2ABgcWLyNYWB_g4pO%2F-Mi2GupdBMHPNwk0mAeW%2FScreen%20Shot%202021-08-26%20at%2012.19.57%20PM.png?alt=media\&token=99314d08-da1e-4259-844d-6cab29b5da6e)

## :format as text delimiter

* Because of how merging lists works (in the codebase) we must take care with what delimiter we use. The delimiter tells the code where to split up the list we are sending. Typically, in JavaScript, a list is created using commas to separate list items, and this works perfect, even when the list item has a comma. BUT, in our case, we are actually tur[ning lists, into strings](https://www.youtube.com/watch?v=jeL5AD2le50) in the Bubble app,[ joining the strings](https://www.youtube.com/watch?v=9Q8BAZffbz8) in the Bubble app, [and then back into lists](https://www.youtube.com/watch?v=HEdikBHsMag) in the plugin. This can create some issues when the titles have commas.&#x20;
* In any event, if you have to `:format as text` _**ONE**_ of your 'required event input fields' you'll need to do it to _**ALL**_ of them&#x20;

{% embed url="https://vimeo.com/570339716" %}
In this example, a tilde is used as the replacement delimiter. You can use any of your liking. Be sure that the delimiter wont appear in the text you plan to display as event titles.&#x20;
{% endembed %}

## Event Titles

* These can be any text. You may want to keep this concise to keep your calendar looking cleaner and put extra info in the other properties such as Extra Property 1/2.
* _**Notice!**_ If your fields might have a comma, you'll need to `:format as text` the list of titles and modify the delimiter as shown in the video below.&#x20;
  * click 'show documentation' below this input to read more about this requirement.&#x20;

![](https://1857871955-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MdYYYaX6u6mOCBpjLIC%2F-MdbvdQvx7mzH7hjIRG2%2F-MdbwYRId1qIqWVoGWdD%2FScreen%20Shot%202021-07-02%20at%2011.59.14%20AM.png?alt=media\&token=26bf17e7-965f-436a-9a4c-c4960a869f6f)

## Start Times / End Times

* &#x20;**IMPORTANT**  you must format your Event Times using the built in `:format as` and selecting `format type: Simplified extend ISO`

![](https://1857871955-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MdYYYaX6u6mOCBpjLIC%2F-MdbvdQvx7mzH7hjIRG2%2F-Mdbw7wZBA2wI9wUcS-P%2FScreen%20Shot%202021-07-02%20at%2011.56.25%20AM.png?alt=media\&token=b87ad622-6331-45fb-a736-0f2b1dd82e54)

{% embed url="https://vimeo.com/570352049" %}
When you add your event date/time sources, be sure to ':format as' and select 'Simplified extended ISO'
{% endembed %}

## Event ID's&#x20;

* This value should be pulled directly from the event data source. This is how the events are related and identified in the DB. When you want to modify an event, this is how the app tells the DB exactly which entry to modify.

![](https://1857871955-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MdYYYaX6u6mOCBpjLIC%2F-Mdbqi3s-9Nq6UtLRISl%2F-MdbuZN4hNMxX-c6-gGz%2FScreen%20Shot%202021-07-02%20at%2011.50.24%20AM.png?alt=media\&token=e6c965a7-a457-4dc8-8eb4-4662af0a0d43)

![](https://1857871955-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MdYYYaX6u6mOCBpjLIC%2F-Mdbqi3s-9Nq6UtLRISl%2F-MdbuqfgjES7QMu0DVYn%2FScreen%20Shot%202021-07-02%20at%2010.48.15%20AM.png?alt=media\&token=0ee37efc-1b06-4924-9ac8-078d30ed52e2)

