Theme Blocks
What This System Does
Theme blocks are dynamic content pieces defined within your theme that can be added to sections. Different sections accept different blocks - some accept all available blocks, others only specific blocks designed for that section.
Most sections in this theme support blocks, but some specialized sections (like those with interactive features that need to share data between components) use fixed layouts instead.
Perfect for: Adding flexible content to sections, creating nested layouts, building sections that adapt to your specific needs
How to Add Blocks
Step 1: Find a Section That Accepts Blocks
- In your Shopify admin, go to Online Store → Themes
- Click Customize next to your live theme
- Click on any section that supports blocks
Step 2: Add Theme Blocks
- Look for the Add block button within the section
- Choose from the available block types (varies by section)
- Some blocks allow you to nest additional blocks inside them
Key Block Behaviors
Block Restrictions
Section-Specific Blocks: Each section only shows compatible block types
- When to use: The theme automatically filters blocks to show only what works in each section
- Pro tip: If you can't find a block type, try adding it to a different section
Nested Blocks
Blocks Within Blocks: Some blocks can contain other blocks up to 8 levels deep
- Best practice: Use nesting to organize related content together
- Example: Add heading and button blocks inside a slide block
Required Blocks
Automatic Blocks: Some blocks appear automatically when certain conditions are met
- When this happens: Adding multiple slides automatically creates navigation controls
- Note: You can customize or hide required blocks, but can't delete them
Pro Tips for Success
Working with Block Types
- Let the theme guide you: Only compatible blocks will show in each section
- Use nesting wisely: Group related content in nested blocks for better organization
- Understand requirements: Some blocks are automatically added and can't be removed
Common Mistakes
- Fighting the system: If a block isn't available in a section, use a different section instead
- Over-nesting: Keep nesting levels reasonable for easier management