Documentation

User Name Block

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

  1. While editing your email template, click theย “+”ย button to add a new block
  2. Search forย “User Name”ย or find it in theย “User”ย category
  3. 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

  1. Use Custom Labels: Customize labels to match your brand voice and email context
  2. Consistent Formatting: Use the same label width across multiple user information blocks for alignment
  3. Personalization: Consider hiding the label for more natural greetings (e.g., “Hello, John!”)
  4. 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