Merge Tag Previews

WARNING

Please enable Smart Merge Tags in order to use Merge tag previews.

When designing personalized email templates, merge tags are essential — they dynamically populate content such as first names, order numbers, or custom links for each recipient.

Merge Tag Previews allow users to see real-time mock data in place of merge tags directly in the Preview mode of the Topol editor. This gives you an accurate visual of how your email will appear to recipients.

To use this feature, you must enable it in the TOPOL_OPTIONS configuration:

enableMergeTagPreview: true,

Once enabled:

1. Navigate to Preview mode inside the editor.

2. Click the Merge Tags - Preview button to toggle the Merge Tag Preview panel.

3. Click it to view mock values for all Merge Tags present in your email.

The editor will display only the tags used in your template and allow you to input placeholder values for them.

If you want to pre-define these test values, you can define default values directly in each Merge Tag’s configuration using the defaultValue property. This way, the Preview fills in these preset values automatically, so you don’t have to enter them manually each time. For details and an example configuration, see Default Merge Tag Values.