The User Name block displays the name of a user in your email templates. This is useful for personalizing emails with the recipient’s name.
Adding a User Name Block
- While editing your email template, click theย “+”ย button to add a new block
- Search forย “User Name”ย or find it in theย “User”ย category
- Click to insert the block
Label Settings
The User Name block includes comprehensive label customization options to control how the label is displayed.
Display Label
Toggle to show or hide the “User Name” label. When enabled, the label appears above or alongside the user name.
Display Label Separator
Toggle to show or hide the separator between the label and user name (e.g., the colon in “User Name: John”).
Custom Label
Override the default “User Name” label with custom text. This is useful when:
- You want a shorter or different label (e.g., “Name”, “Recipient”)
- You need to customize the label for your brand voice
- You want to use a different language
Default: “User Name”
Label Separator
The text that appears between the label and user name. Default is : (colon and space).
Examples:
:ย – User Name: John-ย – User Name – John
Inline Label
Controls whether the label and user name appear on the same line (inline) or stacked vertically.
- Off (Stacked): Label appears above the user name
- On (Inline): Label and user name appear side by side
Bold Label
Makes the label text bold for emphasis.
Label Size
Set a custom font size for the label (supports px, em, rem units).
Label Width
When “Inline Label” is enabled, you can set a fixed width for the label column. This helps align multiple user information blocks.
- Supports px and % units
- Useful for creating aligned lists of user information
Text Alignment
Use the alignment controls in the block toolbar to align the text:
- Left (default)
- Center
- Right
Styling Options
The User Name block supports standard block styling options:
- Colors: Background color, text color, heading color (for labels)
- Typography: Font size, font family, font weight, line height, letter spacing, text transform, text decoration
- Spacing: Padding
- Borders: Border radius, border color, border width, border style
Access these options in the block settings panel under the respective sections.
Examples
Example 1: Simple User Name Display
Goal: Display user name with default label
- Display Label: On
- Label Separator:ย
: - Inline Label: Off (Stacked)
- Result: User name displayed with “User Name:” label above it
Example 2: Personalized Greeting
Goal: Display user name as a greeting
- Display Label: Off
- Text Alignment: Left
- Font Size: 18px
- Font Weight: Bold
- Result: Just the user name displayed prominently
Example 3: Inline Label with Custom Text
Goal: Display user name with custom inline label
- Display Label: On
- Custom Label: “Recipient”
- Inline Label: On
- Label Width:ย
100px - Result:ย
Recipient: John Doeย (aligned layout)
Best Practices
- Use Custom Labels: Customize labels to match your brand voice and email context
- Consistent Formatting: Use the same label width across multiple user information blocks for alignment
- Personalization: Consider hiding the label for more natural greetings (e.g., “Hello, John!”)
- Mobile Considerations: Consider using stacked labels on mobile for better readability
Troubleshooting
User Name Not Showing
- Verify that the email template is being used in a context with user data
- Check that user information is available in the email context
- Ensure the integration (e.g., WordPress, Gravity Forms) is properly configured
Label Not Displaying
- Check that “Display Label” is enabled in the block settings
- Verify the custom label field is not empty if you’re using a custom label
Additional resources
Use the links below for more information and guidance on adding blocks. Keep in mind that these articles are general information related to the WordPress Editor and building with blocks. Email Customizer does not utilize all blocks or functionality due to the limited capabilities of emails.
WordPress Editor