Klaviyo How to Create a New Block

Klaviyo’s email marketing platform revolutionizes how marketers create dynamic, personalized content through its sophisticated block-based editor system. These blocks serve as the fundamental building units that transform simple email templates into powerful conversion-driving campaigns, ranging from basic text and image elements to complex dynamic content that adapts to individual customer behaviors. Mastering block creation becomes essential for any marketer serious about crafting emails that not only capture attention but also drive meaningful engagement and measurable results.

What Are Klaviyo Blocks and Why Do They Matter

Klaviyo blocks function as modular components that allow marketers to build emails with unprecedented flexibility and reusability. Each block serves a specific purpose, whether displaying product information, showcasing customer reviews, or presenting personalized recommendations based on purchase history. The platform’s block system follows a hierarchical structure where templates contain sections, which house individual blocks, creating organized layouts that maintain responsive behavior across all devices.

The true power of Klaviyo’s block system emerges through its ability to create once and deploy everywhere. When you design a compelling product showcase block or craft the perfect promotional banner, you can save it as universal content and use it across multiple campaigns. This approach ensures brand consistency while dramatically reducing the time spent on repetitive design tasks. Modern email marketing demands this level of efficiency, especially when managing multiple campaigns simultaneously.

Essential Block Types for Every Campaign

Klaviyo offers an extensive library of block types designed to meet diverse marketing objectives. Standard blocks include text, image, button, spacer, divider, and HTML blocks that form the foundation of most email templates. These basic elements provide the structure needed for clear communication and visual appeal. More specialized options include product blocks that dynamically pull information from your catalog, social media blocks for showcasing your online presence, and review blocks for highlighting authentic customer feedback.

Dynamic blocks represent Klaviyo’s most sophisticated offerings, enabling content that changes based on recipient data, purchase history, or specific event triggers. Table blocks excel at displaying structured order information, while content repeat blocks showcase multiple items seamlessly. Conditional blocks take personalization further by displaying content only when predetermined criteria are met, such as showing VIP messaging to high-value customers or first-time buyer incentives to new subscribers.

The most effective block selection strategies include:

• Align with campaign objectives: Consider whether you’re sharing straightforward information, showcasing products, or providing personalized order details
• Match content complexity: Use simple blocks for basic messaging and dynamic blocks for personalized experiences
• Consider device compatibility: Ensure your chosen blocks render properly across desktop and mobile devices
• Plan for scalability: Select blocks that can be easily modified and reused across multiple campaigns

Building Your First Block Step by Step

Creating your first block begins with navigating to Klaviyo’s template editor, accessible through either editing an existing template or creating a new one from scratch. The block options panel appears on the left side of your screen, displaying all available block types organized into intuitive categories for easy navigation. Simply drag your desired block type from this panel and drop it into any section of your template to begin customization.

Once you’ve placed your block, clicking on it reveals the block properties panel on the right side of your interface. This panel contains all customization options specific to your chosen block type, allowing precise control over appearance and functionality. Text blocks offer comprehensive editing capabilities including content modification, font styling, size adjustments, color selection, and alignment controls. Image blocks provide options for uploading or selecting images, adding descriptive alt text, and configuring dimensions for optimal display.

Button blocks deserve special attention as they often serve as primary conversion drivers in email campaigns. These blocks offer extensive customization for text content, background and text colors, padding adjustments, and most importantly, link destinations that guide recipients toward desired actions. The real-time preview feature allows you to see immediate updates as you make changes, ensuring your email appears exactly as intended before sending.

Klaviyo’s intuitive interface makes the design process efficient and user-friendly. Visual feedback through the preview pane eliminates guesswork and helps maintain design consistency throughout your template. Regular saving using the “Save” button in the top right corner protects your work and allows for iterative improvements without losing progress.

How to Create Reusable Universal Content

Universal content transforms individual blocks into powerful assets that maintain brand consistency across your entire email program. This feature allows you to design blocks once and deploy them across unlimited templates, ensuring visual coherence while saving significant design time. Creating universal content begins with designing your block within any template until you achieve the desired appearance and functionality.

The process of saving universal content is straightforward yet powerful. Hover over your completed block to reveal the star icon, then click it to open the universal content creation modal. Provide a descriptive name that clearly identifies the block’s purpose and content, making it easy to locate when needed in future campaigns. This naming convention becomes crucial when managing multiple universal content pieces across different campaign types.

Accessing and Managing Universal Content

Your newly created universal content becomes immediately available in the Universal content tab within any template editor. Navigate to Content > Universal in the right sidebar to access your saved blocks and sections. The drag-and-drop functionality remains consistent, allowing you to incorporate universal content into new templates with the same ease as standard blocks. This accessibility ensures team members can maintain brand consistency regardless of their design experience level.

Universal content management extends beyond simple reuse through Klaviyo’s sophisticated editing options. When modifying universal content, you’ll encounter two distinct choices: “Edit across all instances” or “Unlink and edit independently.” The first option propagates changes to every template using that content, ensuring immediate consistency across all campaigns. The second option allows template-specific customization without affecting other implementations, providing flexibility when campaigns require unique variations.

Effective universal content organization requires these strategic approaches:

• Implement clear naming conventions: Use descriptive names that identify the block’s purpose, campaign type, and seasonal relevance
• Categorize by function: Group blocks by their primary purpose such as headers, product showcases, or call-to-action elements
• Regular maintenance schedule: Review and update universal content quarterly to ensure all elements reflect current brand guidelines
• Version control: Keep track of major changes and maintain backup versions of critical universal content pieces

The Universal content section in Klaviyo’s main navigation serves as your central management hub for all reusable elements. This dedicated space allows you to edit, rename, preview, or delete universal content items as your marketing needs evolve. Regular maintenance of this content library ensures your team always has access to current, brand-compliant elements that enhance campaign creation efficiency.

Building Dynamic Blocks for Order Information

Dynamic blocks for order details enable personalized transactional emails that display specific purchase information relevant to each recipient. These blocks prove essential for order confirmations, shipping notifications, and post-purchase follow-ups that require accurate, individualized content. The foundation of effective order detail blocks lies in understanding which metric triggers your email flow and the data structure it provides.

Transactional emails typically utilize the “Placed Order” metric, which contains comprehensive order data including product details, pricing information, shipping costs, and customer information. Table blocks work exceptionally well for displaying this structured data in an organized, scannable format. When configuring these blocks, you must decide between static and dynamic content based on your triggering event and the number of items involved.

Configuring Dynamic vs Static Content

The choice between dynamic and static content depends entirely on your email’s triggering event and expected data structure. Flows triggered by events containing multiple items, such as “Placed Order” or “Checkout Started,” require dynamic configuration to cycle through all items in the order. This setting ensures every product appears in your email regardless of order size. Conversely, single-item events like “Added to Cart” work best with static settings since only one product needs display.

Template tags serve as the bridge between your block design and actual order data. Product names utilize tags like {% item.product.title %}, while prices require {% item.price | currency_format %} for proper formatting. Product images need {% item.product.images.first | image_url: width: 200%} to display correctly with appropriate sizing. These tags pull specific information from order event data and present it in user-friendly formats.

Advanced dynamic blocks benefit from conditional logic that displays different content based on order specifics. You might show special messaging for first-time customers, highlight free shipping thresholds, or present loyalty program benefits for qualifying orders. Testing becomes crucial at this stage—preview your emails with various order scenarios to ensure dynamic content displays correctly across all possible situations.

Setting Up Product Feed Blocks for Recommendations

Product feed blocks showcase relevant items from your catalog based on sophisticated algorithms that consider customer behavior, preferences, and purchase history. These blocks transform static product displays into dynamic recommendation engines that adapt to individual recipients. The foundation of effective product feeds begins with proper setup in your Klaviyo account’s Product Feed section, where you define filtering conditions and weighting factors.

Creating your product feed involves specifying which products should appear based on criteria such as collection membership, inventory status, price ranges, or seasonal availability. Weighting factors add another layer of sophistication by prioritizing products based on newness, popularity, profit margins, or customer affinity scores. These configurations ensure your product recommendations align with both business objectives and customer interests.

Customizing Product Block Appearance

Product blocks offer extensive customization options that control both content and presentation. You can specify the number of products to display, choose between grid or list layouts, and adjust styling elements including padding, borders, typography, and color schemes. Product detail selection allows you to control which information appears, such as titles, prices, descriptions, ratings, or availability status.

Advanced users can create custom product blocks using text blocks with HTML and template tags for unlimited design flexibility. This approach requires technical knowledge but enables unique presentations that stand out in crowded inboxes. The syntax follows patterns like {% feed.[feedname] %} to reference your product feed, followed by iteration loops: {% for product in feed.products limit:4%}. Within these loops, you can display product details using tags like {{ product.title }} and {{ product.price | currency_format }}.

Custom product blocks allow for creative presentations including countdown timers, inventory warnings, personalized pricing, or social proof elements. Web feeds can incorporate real-time data from external sources, enabling dynamic content that updates automatically when emails are opened. While these advanced techniques offer powerful customization options, they require thorough testing across different email clients to ensure compatibility and proper rendering.

Essential SMS Disclosure Block Requirements

SMS disclosure blocks ensure your signup forms comply with telecommunications regulations while building legally sound subscriber lists. These specialized blocks contain required legal language and consent mechanisms that satisfy TCPA and CTIA guidelines, protecting your business from potential compliance issues. Klaviyo simplifies this complex requirement by providing dedicated block types that automatically include compliant disclosure language and necessary policy links.

Adding SMS disclosure blocks to signup forms requires careful attention to legal requirements and user experience considerations. The block automatically generates appropriate disclosure language once you configure your mobile terms of service and privacy policy links. You can create new terms of service documents using Klaviyo’s compliant templates or link to existing documents on your website, ensuring consistency with your overall legal framework.

Compliance Features and Customization Options

SMS disclosure blocks include essential compliance elements that cannot be substantially modified due to legal requirements. These elements encompass checkbox options for explicit consent, links to terms of service and privacy policies, and explanatory text about message frequency and potential carrier charges. Klaviyo’s system validates your forms before publishing, warning you if any required disclosure elements are missing or improperly configured.

Key compliance requirements for SMS disclosure blocks include:

• Explicit consent checkboxes: Recipients must actively opt-in to receive text messages
• Clear frequency disclosure: Inform subscribers about expected message frequency and timing
• Carrier charge warnings: Include standard language about potential message and data rates
• Easy opt-out instructions: Provide clear instructions for unsubscribing from SMS communications
• Privacy policy links: Direct access to your complete privacy policy and data handling practices

Customization options focus on visual presentation rather than legal content, allowing you to adjust colors, fonts, spacing, and overall design to match your brand aesthetic. The core disclosure language remains protected to maintain compliance, but you can modify surrounding elements to create seamless integration with your signup form design. This balance ensures legal protection while maintaining brand consistency and user experience quality.

Proper implementation of SMS disclosure blocks protects your business legally while building subscriber lists that generate genuine engagement. The automated compliance checking prevents common mistakes that could result in regulatory issues or subscriber complaints. By following Klaviyo’s guidance for SMS disclosure blocks, you create a foundation for successful text message marketing campaigns that respect subscriber preferences and legal requirements.

Advanced Block Duplication and Replication

Block duplication streamlines template creation by allowing you to replicate existing blocks with all their content, styling, and configuration settings intact. This time-saving technique proves invaluable when building complex layouts with repeating elements or maintaining design consistency across multiple sections. The duplication process begins by hovering over your target block until the block options appear, then clicking the duplicate icon that resembles two overlapping squares.

Duplicated blocks maintain all original properties while allowing independent customization of content and styling. This approach proves particularly valuable for structured layouts featuring product showcases, feature highlights, or testimonial sections where visual consistency matters more than unique content. After duplication, you can reposition blocks by dragging them to desired locations within your template, then update content while preserving the established design framework.

Cross-Template Block Sharing Strategies

While Klaviyo doesn’t offer direct block copying between templates, universal content provides an effective workaround for cross-template sharing. Create your block in one template, save it as universal content using the star icon, then access it from the Universal tab in any other template. This method ensures consistency across your entire email program while streamlining collaborative workflows when multiple team members work on different campaigns.

Cross-template consistency becomes especially valuable for maintaining brand standards and reducing design time across large email programs. When team members can access standardized blocks through universal content, they spend less time on design decisions and more time on strategic content creation. This standardization also reduces the likelihood of brand inconsistencies that can confuse subscribers or dilute brand recognition.

The strategic use of block duplication and universal content creates efficient workflows that scale with your email marketing program. As your template library grows, these techniques become essential for maintaining quality while meeting increasing campaign demands. Regular organization of universal content ensures your team always has access to current, brand-compliant elements that enhance campaign effectiveness.

Third-Party Integration Block Strategies

Third-party integrations expand Klaviyo’s native capabilities by incorporating specialized functionality from partner platforms directly into your email blocks. These integrations enable dynamic content from review platforms, survey tools, social media feeds, and recommendation engines that enhance engagement and provide additional value to subscribers. Popular integrations include review platforms like REVIEWS.io, Okendo, and Yotpo, which display authentic customer feedback, and survey tools like Survicate that embed interactive questions directly in emails.

Establishing third-party integrations typically requires initial setup in your Klaviyo account settings and configuration of data feeds between platforms. Most integrations provide specific code snippets that you paste into text blocks using the source view, enabling dynamic content that updates automatically based on recipient data or real-time information. These snippets often include special tags that pull relevant content when emails are sent, creating personalized experiences that go beyond standard email capabilities.

Implementation Best Practices

Review integrations often involve setting up web feeds in Klaviyo that pull data from review platform APIs, then referencing these feeds in your emails using Klaviyo’s template language. Similar approaches apply to loyalty program information, social proof elements, and recommendation engines that display personalized content based on individual customer interactions. The key advantage lies in delivering relevant, timely content that increases engagement and conversion rates.

Technical implementation requires comfort with HTML and template tags, but the resulting dynamic content significantly enhances email marketing effectiveness. These integrations create emails that feel more like personalized experiences than mass communications, leading to higher engagement rates and stronger customer relationships. The investment in technical setup pays dividends through improved campaign performance and subscriber satisfaction.

Successful third-party integrations require thorough testing across different email clients and recipient scenarios to ensure proper rendering and functionality. While implementation may require technical expertise, the enhanced personalization and engagement capabilities justify the effort for serious email marketers seeking competitive advantages in crowded inboxes.

Troubleshooting Common Block Issues

Block-related issues can significantly impact email performance and subscriber experience, making troubleshooting skills essential for email marketers. Inconsistent display across different email clients represents one of the most frequent challenges, as rendering varies significantly between providers like Gmail, Outlook, and Apple Mail. Complex styling and advanced features often cause compatibility problems that affect how subscribers view your carefully crafted content.

Mitigation strategies focus on testing and simplification to maximize compatibility across email clients. Always use Klaviyo’s preview functionality and send test emails to accounts with different providers to identify potential issues before campaign launch. Keep designs relatively simple and use table-based layouts for critical content blocks, as these render more consistently across various email clients than complex CSS-based designs.

Dynamic Content Display Problems

Dynamic blocks frequently encounter issues when there’s a mismatch between available event data and block configuration settings. For example, configuring a product block as dynamic when using an “Added to Cart” event (which contains only one item) may prevent proper display. Understanding your event data structure and matching block configuration to available data prevents these common problems.

Flow email testing requires previewing with different customer profiles to confirm proper rendering across various scenarios. Check that your triggering events contain the data your blocks expect to display, and verify that template tags reference correct data fields. When dynamic content fails to appear, review your event data structure and adjust block configuration accordingly.

Image-related issues including broken images, improper sizing, and poor mobile responsiveness require systematic troubleshooting approaches. Ensure all images are properly uploaded to Klaviyo’s content library and use relative sizing (percentages rather than fixed pixels) for responsive behavior. Text formatting inconsistencies often occur when copying content from external sources, requiring source editor cleanup to remove unexpected HTML that affects display.

Start Building Better Klaviyo Blocks Today

Mastering Klaviyo’s block system transforms your email marketing from basic communications into sophisticated, personalized experiences that drive real business results. The techniques covered throughout this guide provide the foundation for creating emails that not only capture attention but also convert subscribers into loyal customers. From basic block creation to advanced dynamic content and third-party integrations, these skills enable you to leverage Klaviyo’s full potential for your marketing campaigns.

The investment in learning proper block creation techniques pays immediate dividends through improved campaign performance, reduced design time, and enhanced brand consistency across all email communications. As you implement these strategies, focus on building a library of universal content that serves your long-term marketing objectives while maintaining the flexibility to adapt to changing campaign needs. Your subscribers will notice the difference in email quality, leading to higher engagement rates and stronger customer relationships that drive sustainable business growth.