Knowing how merge field codes translate to visible text helps you create effective emails.
-
Recognize the merge field structure
-
Merge fields follow this pattern: {{OfficialType_NameFormat_ContactInfo}}
-
Example: {{UsSenators_Prefix_FullName_Phone_Twitter}}
-
-
Interpret the components
-
First part indicates the official type (e.g., UsSenators, StateGovernor)
-
Middle part shows name format (e.g., Prefix_FullName, Prefix_LastName)
-
Last part indicates contact info (e.g., Phone, Twitter, Phone_Twitter)
-
-
Anticipate the output format
-
For single officials: "Sen Elizabeth Warren at (202) 224-4543"
-
For multiple officials: "Sen Elizabeth Warren at (202) 224-4543 and Sen Ed Markey at (202) 224-2742"
-
With multiple contact methods: "Sen Warren at (202) 224-4543 or at @SenWarren"
-
-
Reference output examples
-
Full name with phone: "Sen Elizabeth Warren at (202) 224-4543"
-
Last name with Twitter: "Sen Warren at @SenWarren"
-
No name, phone only: "(202) 224-4543"
-
No name, both contacts: "(202) 224-4543 or at @SenWarren"
-
-
Test your email
-
Send a test email to yourself to verify how the merge fields appear
-
Check that the right officials display for different test addresses
-
