-
Notifications
You must be signed in to change notification settings - Fork 10
Blocks Section
Category: Design | Keywords: section, stack, vertical, layout, container
Updated in 2.1.0 — Section now automatically clears default padding when nested inside another Section.
Create vertical stacking containers for organizing content areas. Perfect for page layouts, hero sections, and content sections. Maintains centered, constrained layouts with full-width backgrounds.
Key Features:
- Vertical flex layout (use Transform → Row for a horizontal layout)
- Width constraint system (enabled by default, typically 1140px)
- Overlay color support for image backgrounds
- Hover effects with context propagation to child blocks
- Semantic HTML elements (section, article, header, footer, main)
- Add Block → Search "Section" in Design category
- Add Content → Insert blocks (headings, paragraphs, images, buttons)
- Configure Width → Constrain Inner Width: ON (default, 1140px)
- Style → Background, padding, overlay color
- Full width alignment + background image
- Overlay Color: Dark semi-transparent
- Min Height: 100vh | Justification: Center
- Content: H1 + Paragraph + Buttons
-
Constrain Inner Width: ON (default) - Centers content with max-width
- ON: Full-width background, centered content (1140px)
- OFF: Content spans full container width
- Max Content Width: Custom width (960px, 1140px, 1200px, 1400px)
When to Disable:
- Full-width galleries/images
- Nested sections (parent already constrains)
- Intentional edge-to-edge designs
When a Section block is placed inside another Section block, DesignSetGo automatically clears the inner Section's default padding so spacing doesn't compound. Only the explicitly-set (non-default) padding values are preserved; if you want padding on the inner Section you can still set it manually and it will be respected. This prevents accidental double-spacing in layouts that use Sections for structural grouping.
Orientation: Always vertical. For a horizontal layout, transform the block to Row (block toolbar → Transform), which keeps its settings and inner blocks.
Justification (vertical distribution):
- Top: Items at top, space below
- Center: Centered, equal space top/bottom (hero sections)
- Bottom: Items at bottom, space above
- Space Between: Items spread, space distributed
- Background: Color, gradient, or image
- Text Color: Cascades to child blocks
- Overlay Color: 80% opacity over background images (improves text readability)
Hover Settings (interactive sections):
- Hover Background/Text Color
- Hover Icon/Button Background (propagates via context to DesignSetGo blocks)
HTML Element: div, section, article, aside, header, footer, main
-
<section>: Page sections (most common) -
<article>: Blog posts, independent content -
<header>: Page header (once per page) -
<footer>: Page footer (once per page) -
<main>: Main content (once per page)
- Alignment: Full (typical for sections)
- Background Image: Add with cover, center, no-repeat
- Spacing: Padding (XL top/bottom typical), margin, block gap
- Dimensions: Min Height (100vh for full-height, 500px for heroes)
- Typography: Font size, line height (cascades to children)
- Border: Color, style, width, radius
- Shadow: Box shadow for elevated sections
- Min Height: 100vh | Justification: Center
- Background: Image + overlay color (dark, 80%)
- Content: H1 + Paragraph + Buttons
- Constrain: ON (1140px)
- Background: Light color
- Padding: XXL top/bottom
- Content: H2 + Paragraph + Grid (3 columns)
- Constrain: ON (1140px)
- HTML Element:
<article>or<section> - Constrain: ON (960px for readability)
- Padding: XL top/bottom
- Content: Headings, paragraphs, images
- Background: Brand color/gradient
- Text: White (high contrast)
- Justification: Center
- Content: H2 + Paragraph + Button
- Constrain: ON (800px)
- HTML Element:
<footer> - Background: Dark color
- Text/Link Color: Light
- Content: Grid (3-4 columns) + links
- Constrain: ON (1140px)
- Use full-width with constrained inner content
- Alternate background colors between sections
- Use adequate padding (XL or XXL)
- Set semantic HTML elements
- Use overlay colors for text over images
- Combine Section + Grid/Row for complex layouts
- Use same background for all sections
- Nest sections unnecessarily
- Skip section headings
- Forget to test mobile
- Use images without overlay
<header> → Header Section (logo, nav)
<main>
<section> → Hero (background image, overlay)
<section> → Features (light bg, grid)
<section> → Content (white bg)
<section> → CTA (brand color)
</main>
<footer> → Footer Section (dark bg)
Section (full-width, constrained)
└─ Grid (3 columns)
├─ Feature 1
├─ Feature 2
└─ Feature 3
Full-width with constraint ON:
┌───────────────────────────┐
│ /// Full-width bg ///// │
│ ┌─────────────┐ │
│ │ Constrained │ │
│ │ 1140px max │ │
│ └─────────────┘ │
└───────────────────────────┘
Semantic HTML:
- Use
<section>for distinct content areas - Use
<header>,<footer>,<main>once per page - Use
<article>for independent content
Heading Hierarchy: H1 → H2 → H3 (never skip levels)
Color Contrast: 4.5:1 minimum for text, use overlay for images
Keyboard: Logical tab order, visible focus states
Content not centering?
- Verify Section alignment: Full Width
- Enable "Constrain Inner Width"
- Check theme overrides
Background image not showing?
- Set Background Size: Cover
- Add Min Height (e.g., 500px)
Overlay not visible?
- Set background image first
- Then set overlay color in Color panel
Vertical justification not working?
- Set Min Height for section (justification needs extra space)
Full-Height Sections: Min Height: 100vh + Justification: Center
Alternating Backgrounds: White → Light Gray → Brand Color → White
Width Guidelines:
- 960px: Text-heavy (blog posts)
- 1140px: General content
- 1200-1400px: Wide feature sections
Combining Blocks: Section → Grid (features) | Section → Row → Image + Text
Version 1.0.0 | WordPress 6.4+ | Report Issues
Auto-generated from
docs/blocks/SECTION.md. To update, edit the source file and changes will sync on next push to main.
- Accordion
- Advanced Heading
- Blobs
- Breadcrumbs
- Card
- Chart
- Comparison Table
- Countdown Timer
- Counter Group
- Divider
- Dynamic Image
- Fifty Fifty
- Flip Card
- Form Builder
- Grid
- Hotspot
- Icon
- Icon Button
- Icon List
- Image Accordion
- Map
- Modal
- Modal Api Reference
- Modal Auto Triggers
- Modal Fse Compatibility
- Modal Gallery Navigation
- Modal Trigger
- Pill
- Product Categories Grid
- Product Showcase Hero
- Progress Bar
- Query
- Query Filter
- Query Group Header
- Query No Results
- Query Pagination
- Query Results
- Row
- Scroll Accordion
- Scroll Marquee
- Scroll Slides
- Section
- Section Divider
- Slider
- Star Rating
- Sticky Sections
- Table Of Contents
- Tabs
- Text Path
- Timeline
- Background Video
- Block Animations
- Clickable Group
- Conditional Visibility
- Custom Css
- Draft Mode
- Dynamic Tags
- Expanding Background
- Grid Mobile Order
- Grid Span
- Hover Effects
- Max Width
- Responsive Visibility
- Reveal Control
- Scroll Parallax
- Sticky Header
- Style Binding
- Svg Patterns
- Text Alignment Inheritance
- Text Reveal
- Abilities Api
- Abilities Api Guide
- Block Bindings
- Draft Mode Api
- Interactive Blocks
- Markdown Content Negotiation
- Rest Api Reference
- Wp Cli Reference
- Ai Assisted Development
- Best Practices Summary
- Block Controls Organization
- Block Development Best Practices Comprehensive
- Block Exclusion Guide
- Deploying To Wordpress Org
- Design System
- 2026 04 16 Blocks Editor Ux Design
- 2026 04 17 Theme 3 Inspector Ia
- 2026 04 21 Query Block Onboarding
- 2026 04 21 Query Capable Layout Blocks Design
- 2026 04 27 Block Roadmap Ideas
- 2026 07 01 Shape Divider Theme Inheritance
- 2026 07 02 Icon Block Dynamic Render Pilot
- 2026 07 06 Section Divider Block Design
- 2026 07 06 Section Style Variations Fse Design
- 2026 07 06 Section Styles Editor Preview
- 2026 07 07 Row Grid Overlay Hover Parity Design
- 2026 07 21 Conditional And Dup Label Sourcing
- 2026 07 23 Theme Block Type Animation Defaults
- 2026 08 16 Chart Block
- 2026 08 16 Greenshift Gap Roadmap
- 2026 08 17 Woocommerce Surface
- 2026 08 24 Loop Carousel
- 2026 08 24 Star Rating Block
- 2026 09 17 Abilities Drift Prevention
- 2026 09 17 Abilities Drift Prevention Implementation
- 2026 09 29 Existing User Regression Fixes
- 2026 09 29 Release Preflight Fixes
- Readme
- 2026 07 02 Block Authorability Audit
- 2026 09 29 Regression Fixes
- 2026 09 29 Release 2.9.0
- 2026 09 29 Release Fixes