Skip to content

Content Blocks

Content Blocks allow you to manage reusable, cross-channel content in a single, centralized location. Use them to create a consistent look and feel across your campaigns, distribute the same offer codes through different channels, or build pre-defined assets for consistent messaging at scale. You can also create and manage your Content Blocks using the API.

Create a Content Block

There are two types of Content Blocks: drag-and-drop and HTML. Each type corresponds to its editor.

  1. Go to Templates > Content Blocks. Select Create Content Block and select Drag-and-drop Content Block.
  2. Drag and drop the editor blocks to build a drag-and-drop Content Block.
  3. Drag and drop a format block from the Rows tab into the editor to create the layout of your Content Block.

    Drag-and-drop Content Block composer.

  4. Add drag-and-drop Content Blocks as needed to build out your email campaigns.
  5. After creating your Content Block, select Done.
  6. Give your Content Block a name. This name will auto-populate as part of the Content Block Liquid Tag.
  7. (Optional) Add a description.
  8. Select the Preview tab to view how your Content Block will appear. Optionally select Copy preview link to generate and copy a shareable preview link that shows what the email will look like for a random user. The link will last for seven days before it needs to be regenerated.

    Preview tab for the drag-and-drop Content Block composer.

  9. Select Launch Content Block.
  1. Go to Templates > Content Blocks. Select Create Content Block and select HTML code editor.
  2. Enter your HTML in the HTML tab, or build your Content Block in the Classic tab.

    HTML code editor composer.

  3. After creating your Content Block, select Done.
  4. Enter a name for your Content Block. This name will auto-populate as part of the Content Block Liquid Tag.
  5. (Optional) Add a description.
  6. Select the Preview tab to view how your Content Block will appear. Optionally select Copy preview link to generate and copy a shareable preview link that shows what the email will look like for a random user. The link will last for seven days before it needs to be regenerated.

    Preview tab for the HTML code editor composer.

  7. Select Launch Content Block.

Content Block specifications

Use Content Blocks

After creating your Content Block, you can insert it in your messages using the editor or Liquid.

Using the drag-and-drop editor

To add a Content Block in the drag-and-drop editor:

  1. Go to the Rows tab in the editor and select Content Blocks.
  2. Drag and drop your Content Block into the email editor.
  3. (Optional) Adjust the width of your Content Block by selecting the button in the navigation menu. The default width is 100% when not specified in your email global style settings; otherwise, the global settings will be honored.

    A double-sided arrow with an option to edit the width.

Misalignment in the drag-and-drop editor can occur when multiple Content Blocks are added to a single row block. Try using separate row blocks to maintain alignment across your content at the row level.

Using Liquid

To insert a Content Block using Liquid:

  1. Copy the Content Block Liquid Tag from the Content Block Details section.
  2. Insert the Content Block Liquid tag into the message. You can also begin typing the Liquid and have the tag auto-populate.

In the drag-and-drop editor, you can also add a Content Block via the Personalization panel:

  1. Go to your email campaign and select Edit Email Body.
  2. Click Personalization.
  3. Select Content Blocks in the Personalization Type dropdown.
  4. Select the name of your Content Block in the Attribute field.
  5. Copy and paste the Liquid snippet into a text editor block.
    The Add Personalization tab with options.

Things to know

  • Using HTML Content Blocks in drag-and-drop emails or drag-and-drop Content Blocks in HTML emails may result in unexpected rendering issues. This is because the drag-and-drop editor generates HTML and CSS that dynamically renders the content, whereas the HTML editor is more static.
  • Canvas event properties are only supported in a Canvas. If you reference a Content Block with Canvas entry properties in a campaign, it won’t populate.

Preview Content Blocks

After adding a Content Block in an active campaign or Canvas, you can preview it from the Content Blocks Library by hovering over the Content Block and selecting the Preview icon.

This preview includes information about the Content Block such as who created it, tags, creation date, last edited date, description, editor type, inclusion count with details (a clickable list of messages or Content Blocks that use the Content Block), and an actual preview of the Content Block.

A preview of a Content Block "Workout_Promo" for cycling and dancing that has one inclusion.

Nest Content Blocks

Content Blocks can be nested, but only once. You can nest Content Block A into Content Block B, but you will not be able to then nest Content Block B into Content Block C.

Update and copy Content Blocks

If you choose to update a Content Block, it will update in all messages where the Content Block is inserted via Liquid. If the Content Block is imported using the Content Blocks dropdown under Rows in the drag-and-drop editor, it won’t be updated in all messages.

If you want to update a Content Block for a single message or make a copy to use in other messages, you can either copy the HTML from the original message to your new one, or edit the original Content Block (it must have been used in a message already) and save it. You will get a prompt that allows you to save it as a new Content Block.

After making edits to a Content Block, you can save and launch the updated Content Block by selecting Launch Content Block. Or, you can select More > Duplicate to create a duplicate of your Content Block.

A Content Block that reads "Welcome to our newsletter".

Use email footers in Content Blocks

Content Blocks cannot be used within an email footer, but you can create a Content Block that includes footer content for use in your emails. To do so:

  1. Go to Settings > Email Preferences > Custom Footer and create the footer.
  2. Add the footer to a Content Block in the Content Blocks Library.
  3. Add that Content Block to your email templates or messages.

Archive Content Blocks

Expanded Settings dropdown menu that shows three options: Archive, Duplicate, and Copy to workspace.

Once you have finished using a Content Block, you can archive it from the Templates page. Archived Content Blocks are read-only, so unarchive the Content Block before editing. Content Blocks cannot be archived if they’re used in any messages.

Best practices

  • When your block is only used in a few emails, we recommend archiving the outdated block and updating your live messages with a newer block that has not been archived.
  • When your block only has a typo or needs a minor change, we do not recommend archiving the block. Instead, update the block and get sending!
  • When your block is used in more messages than you can reasonably manage with the first suggestion in this list, we recommend removing all content from the block. This prevents the inclusion of outdated information in any messages.
  • If you accidentally archive a Content Block, you can unarchive it.

Saved Content Blocks panel where the settings dropdown menu for "Test_32" is expanded to show three options: Unarchive, Duplicate, and Copy to workspace

New Stuff!