Appearance
SmartCodes in the FluentCRM Email Editor
SmartCodes are dynamic tokens you place inside your email subject lines, pre-headers, and body content. When FluentCRM sends the email, every token is replaced with the real value for that contact — so one email template can greet each subscriber by name, show their company, link to their personal unsubscribe page, and more.
This article explains the two types of SmartCodes, lists every available token, and shows you where to find and insert them in the editor.
Types of SmartCodes
FluentCRM organises SmartCodes into two groups:
- Primary SmartCodes — built-in tokens for contact profile fields, general CRM/site values, and WordPress user data. These are always available.
- Additional SmartCodes — tokens generated from your own Custom Fields and from third-party plugin integrations (LMS courses, membership levels, etc.). These appear automatically once you create custom fields or activate an integration.
Where to find SmartCodes in the editor
Open any email template, campaign, or sequence step in the Email section. In the editor toolbar, click the SmartCode button (or the {} shortcut). A panel opens listing every available token grouped by category. Click any token to insert it at your cursor position.
Primary SmartCodes
Contact
These tokens pull from the contact's profile stored in FluentCRM.
| SmartCode | What it returns |
|---|---|
{{contact.full_name}} | Full name |
{{contact.prefix}} | Name prefix (Mr., Ms., Dr., etc.) |
{{contact.first_name}} | First name |
{{contact.last_name}} | Last name |
{{contact.email}} | Email address |
{{contact.id}} | Contact's unique numeric ID |
{{contact.user_id}} | Linked WordPress user ID |
{{contact.address_line_1}} | Address line 1 |
{{contact.address_line_2}} | Address line 2 |
{{contact.city}} | City |
{{contact.state}} | State / Province |
{{contact.postal_code}} | Postal / ZIP code |
{{contact.country}} | Country |
{{contact.phone}} | Phone number |
{{contact.status}} | Subscription status |
{{contact.date_of_birth}} | Date of birth |
{{contact.company.name}} | Company name |
{{contact.company.industry}} | Company industry |
{{contact.company.address}} | Company address |
{{contact.created_at}} | Date the contact was added |
General
These tokens pull from your FluentCRM settings, your WordPress site, or are computed at send time.
| SmartCode | What it returns |
|---|---|
{{crm.business_name}} | Business name from FluentCRM Settings |
{{crm.business_address}} | Business address from FluentCRM Settings |
{{wp.admin_email}} | Admin email from WordPress settings |
{{wp.url}} | Your site URL |
{{other.date.+2 days}} | Dynamic date — replace +2 days with any relative date string; returns a formatted date at send time |
{{other.date_format.D, d M, Y}} | Custom date using any PHP date format |
{{other.latest_post.title}} | Title of the most recently published post |
##crm.unsubscribe_url## | Unsubscribe URL for the contact |
##crm.manage_subscription_url## | Manage subscriptions page URL |
##web_preview_url## | Web preview (view in browser) URL |
{{crm.unsubscribe_html|Unsubscribe}} | Ready-made unsubscribe hyperlink (link text: "Unsubscribe") |
{{crm.manage_subscription_html|Manage Preference}} | Ready-made manage-subscription hyperlink (link text: "Manage Preference") |
CAN-SPAM / GDPR reminder: Your email footer should always include your business address and a working unsubscribe link. Use
{{crm.business_address}}and the unsubscribe tokens above to make this automatic.
WP User
These tokens are available when a contact is also a registered WordPress user.
| SmartCode | What it returns |
|---|---|
{{wp_user.display_name}} | User's display name |
{{wp_user.user_login}} | Username (login) |
##wp_user.password_reset_url## | Password reset URL (for use in buttons / links) |
{{wp_user.password_reset_url}} | Password reset URL (plain text) |
{{wp_user.meta.META_KEY}} | Any WordPress user meta value — replace META_KEY with the actual meta key |
Additional SmartCodes
Custom Fields
Any Custom Fields you create in FluentCRM → Settings → Custom Fields automatically generate their own SmartCodes. They appear in the SmartCode panel under the Custom Fields group, named after the field label you set.
For example, if you created custom fields called Number, Gender, Login Date, and Description, you will see a matching token for each in the panel.
To learn how to create custom fields, see Custom Contact Fields.
Integrations
When you connect a third-party plugin — such as an LMS, membership platform, or ecommerce tool — FluentCRM adds integration-specific tokens to the SmartCode panel. These let you reference course enrolments, membership levels, order data, and similar plugin-side values directly in your emails.
For example, with TutorLMS connected you might see tokens for enrolled course names and course links.
Available tokens depend on which integrations are active on your site. Head to FluentCRM → Settings → Integrations to connect plugins and unlock their SmartCodes.
Practical tips
- Fallback values: If a token might be empty for some contacts (for example,
first_nameis not always filled), consider writing your copy to work naturally even when the token returns nothing — for example, "Hi there" as a fallback greeting. - Subject lines: SmartCodes work in subject lines too. Personalising the subject with the contact's first name can noticeably improve open rates.
- Testing: Use Send a test email from the editor toolbar and enter your own email address. Your own contact record values will be used, so you can verify that every token resolves correctly before sending.