Shortcodes Panel

What is this for?

The Shortcodes Panel appears below the Email Body editor in the Email Action popup. It provides one-click copy buttons for dynamic placeholders (shortcodes) that inject event-specific and subscriber-specific data into your emails. When the email sends, each shortcode is replaced with real data — the event link, event name, start time, subscriber identity, or calendar-add buttons. This lets you write one template that auto-personalizes for every recipient.

Where to Find It

1. Open the Email Action popup (create new or edit existing).
2. Go to the Email Body field (rich text editor).
3. Below the editor toolbar, you'll see a section titled "Short codes panel" with colored icon buttons.

Available Shortcodes

How to Use a Shortcode

1. Place your cursor in the Email Body editor where you want the dynamic content.
2. Click the desired shortcode button on the panel.
3. The shortcode text (e.g., {eventLink}) is copied to your clipboard.
4. A toast appears: "Success copy: [shortcode name]" (translated to your language).
5. Paste (Ctrl/Cmd+V) at the cursor position in the editor.
6. The shortcode appears in your text. Format it like any text (bold, color, link, etc.).

Tip: You can paste the same shortcode multiple times — each click copies it fresh to clipboard.

Details & Behavior Per Shortcode

{eventLink}

• Resolves to: The full public URL to the event/registration page.
• Typical use: Wrap in a link: <a href="{eventLink}">Register</a> or paste as raw URL.
• Works for: All recipient types (Subscriber, Owner, Custom email).

{eventTime}

• Resolves to: Formatted event start date/time (e.g., "June 15, 2024 at 10:00 AM").
• Timezone: Uses the event's configured timezone.
• Works for: All recipient types.

{eventName}

• Resolves to: The exact Event Name entered in the Event Constructor.
• Works for: All recipient types.

{userIdentity}

• Resolves to: The subscriber's display identity — typically their name if provided, else their email.
• Visibility: Hidden from the panel when Recipient = Owner. Only shows for Subscriber and Custom email.
• Why: Emails to the Owner have no specific subscriber context — the organizer knows who they are.

{addToCalendar}

• Resolves to: Two styled buttons — Google Calendar and Outlook — each with a pre-filled .ics link containing the event's name, date/time, and description.
• Typical use: Place on its own line: "Save the date: {addToCalendar}"
• Works for: All recipient types.

Important Rules & Tips

Note: Shortcodes are case-sensitive and must include the curly braces. Type or paste exactly as shown: {eventLink}, {eventTime}, {eventName}, {userIdentity}, {addToCalendar}.

Copy-Paste Workflow: Buttons copy to clipboard — they do NOT auto-insert into the editor. You must Paste (Ctrl/Cmd+V) at the cursor position. This gives you full control over placement and formatting.

Recipient-Dependent Panel: The User Identity button ({userIdentity}) disappears from the panel when you change Recipient to Owner in the same popup. Switch back to Subscriber or Custom email — the button reappears.

Character Count: Shortcodes count toward the 300-char Body limit by their raw length (e.g., {eventLink} = 11 chars). The final rendered email will be longer after substitution — this is fine.

Preview: Use the Preview Email button (green "preview email" button in the popup) to see how the email looks with shortcodes resolved for a test recipient.

Templates: Shortcodes work in any template. The template provides layout; shortcodes provide dynamic data.

Common Questions & Troubleshooting

I clicked a button but nothing appeared in the editor. The button copies to clipboard. You must Paste (Ctrl/Cmd+V) at the cursor position in the editor. Check your clipboard — the shortcode text should be there.

The User Identity button is missing. You likely have Recipient = Owner selected. Change to Subscriber or Custom email — the button will appear.

Can I type shortcodes manually instead of using buttons? Yes. Type them exactly with braces: {eventLink}, {eventTime}, etc. Buttons are just a convenience to avoid typos.

What if the event doesn't have a link/name/time? The system requires an Email Template to be selected. The template's event context provides the data. If event data is missing, the shortcode resolves to an empty string or placeholder — ensure your event is fully configured.

Do shortcodes work in the Email Subject line? No. Shortcodes only work in the Email Body editor. The Subject field is plain text only.

Can I style the calendar buttons? The {addToCalendar} shortcode renders pre-styled Google/Outlook buttons. You cannot customize their appearance via the editor — they use a system default for maximum compatibility.

What happens if I send to a Custom email?

• {eventLink}, {eventTime}, {eventName}, {addToCalendar} → resolve normally with event data.
• {userIdentity} → resolves to the custom email address you entered (since there's no subscriber profile).