Personalization allows you to dynamically insert recipient-specific information into your emails, making them more engaging and relevant. IndiePitcher supports personalization using double curly braces {{ variable }}.

Email personalization is supported when sending a campaign through the IndiePitcher dashboard, and by following API endpoints:

Both markdown and HTML email content supports personalization.

Sending a simple transactional email and the SMTP proxy currently do not support personalization.

​
How It Works

Personalization fields are placeholders within your email content that are replaced with actual data from your contact list when the email is sent. For example, if you want to address your recipient by their first name, you can use the {{ firstName }} placeholder. Fallback values can be specified by using {{ firstName|default:"there" }}.

​
Supported Properties

The following fields are available for personalization:

​
Default Fields

  • {{ name }}: Maps to the contact’s name property if available.
  • {{ firstName }}: Synthesized from the contact’s name if available.
  • {{ lastName }}: Synthesized from the contact’s name if available.
  • {{ email }}: Maps to the contact’s email. Always available.
  • {{ userId }}: Maps to the contact’s userId property if available.
  • {{ avatarUrl }}: Maps to the contact’s avatarUrl property if available.
  • {{ languageCode }}: Maps to the contact’s languageCode property if available.
  • {{ companyName }}: Represents the company name you set in your project’s settings. Useful for custom HTML emails to include your company name in the email footer.
  • {{ companyAddress }}: Represents the company address you optionally set in your project’s settings. Useful for custom HTML emails to include your company name in the email footer.
  • {{ unsubscribeURL }}: URL to unsubscribe from the mailing list this email belongs to. Not present if you’ve selected the important mailing list, users cannot unsubscribe from receiving important emails. Useful for custom HTML emails to provide a one click unsubscribe button in the footer of your email.
  • {{ manageSubscriptionsURL }}: URL to manage the recipients mailing list subscriptions. Not present if you’ve selected the important mailing list. Useful for custom HTML emails to provide a manage your subscriptions button in the footer of your email.

​
Custom Fields

IndiePitcheer supports custom properties that you can define for your contacts. These properties can also be used for personalization in your emails. Custom contact properties can be accesed using the {{ custom.<propertyName> }} syntax to avoid possible name collisions with the fields IndiePitcher provides by default and may introduce in the future.

Example

{{ custom.companyName }}

​
Fallback Values

Sometimes, the contact data may not include a value for a placeholder. To avoid sending emails with blank fields, you can specify a fallback value.

Example

Hi {{ firstName|default:"there" }},

If the recipient’s first name is unavailable, the placeholder will default to “there.”

Result (for a recipient with no first name data):

Hi there,