---
description: This add-on allows you to insert events into your emails.
---

# JCal Pro

### Insert events in an email

{% tabs %}
{% tab title="One by one" %}
![](https://963725040-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L_D4iy53WFAtKVs3BPA%2F-MjdL9_i2dQnyq9rERgE%2F-MjdTLWjuPkjB9VQNzJQ%2Fone%201.png?alt=media\&token=ce56bca6-2418-4e56-9f83-315efc004aa9)

* **Content to insert**: The listed events are ordered by starting date, for events with multiple occurrences you can hover the displayed date to see the full version with the starting hour.
* **Display**: Choose here the content you want to be inserted in your email

![](https://963725040-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L_D4iy53WFAtKVs3BPA%2F-MjdL9_i2dQnyq9rERgE%2F-MjdTbOQH8CE78kz3Efr%2Fone%202.png?alt=media\&token=dd48982d-4721-41f6-ab22-a8d1404ef0a8)

* **Pictures**: You can resize or remove pictures included in the description part of the event you insert in your email.
* **Clickable title**: A link will be added on the event's title, leading to this event's detail page on your site
* **Truncate the text**: This will cut the description part of the event you insert
* **Read more**: If turned On, a "Read more" link will be added just below the inserted event
* **Custom view**: You can edit the view of the events that you insert&#x20;
{% endtab %}

{% tab title="By category" %}
If you select "By category", you will be able to insert multiple events at a time.

![](https://963725040-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L_D4iy53WFAtKVs3BPA%2F-MjdL9_i2dQnyq9rERgE%2F-MjdU2wDC5nU0TNr_GQj%2Fcat%201.png?alt=media\&token=6cee0377-c020-45ab-a8e1-95d47fbaf0da)

* **Content to insert**: You can insert events of one or more categories, or all events if you don't select any category
* **Display and Pictures**: see "One by one" options

![](https://963725040-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L_D4iy53WFAtKVs3BPA%2F-MjdL9_i2dQnyq9rERgE%2F-MjdUGk-cZ5kzLbfPfDh%2Fcat%202.png?alt=media\&token=3e0ff9aa-f8d0-4058-8fb9-9dbbf5646ddb)

* **First options**: see "One by one" options
* **Only featured elements**: You can choose to only insert featured events with this option
* **Order by**: By default, events are sorted by starting date to show the ones about to begin first
* **From**: Only insert events starting after the specified date. You can specify a relative date if you're currently creating a campaign sent automatically in its "Send settings" tab.
* **To**: Only insert events starting before the specified date.
* **Columns**: You can insert for example 2 events per row in your email&#x20;
* **Column horizontal padding**: Allows you to adjust the horizontal padding between 2 columns
* **Column vertical padding**: Allows you to adjust the vertical padding between 2 columns
* **Max.number of elements**: This is the maximum number of events inserted in your email
* **Automatic campaigns options**: See [the dedicated documentation](../../../main-pages/campaigns/automatic-campaigns#dont-send-twice-the-same-content)
{% endtab %}
{% endtabs %}

### Settings

Here are the settings available for this add-on:\
**Custom view**: override the content inserted in your email\
**Front-end access**: this settings allows you let your users access to this add-on in the frontend campaign management or not\
**Hide past events**: This option allows you to hide or not past event in the listing in the drag & drop editor
