Effects · Gutenberg
Parallax Section block for WordPress
A full-width content section with a background image that scrolls at a different speed for a depth parallax effect.
Get Blockenberg
Free Gutenberg block in Blockenberg. The inspector controls and front-end behavior on this page come from this block’s source, not a shared stub.
What it actually does
A full-width content section with a background image that scrolls at a different speed for a depth parallax effect.
Inspector panels on this block: Background Image, Parallax Effect, Overlay, Layout. Those titles come from index.js, not from a shared template.
Behavior controls: “Background Size” options: Cover, Contain, Auto; “Background Position” options: Center Center, Top Center, Bottom Center, Center Left, Center Right; “Parallax Speed” (0.05 = subtle · 0.5 = medium · 0.9 = strong); “Direction” options: Top → Bottom, Bottom → Top, Left → Right, Right → Left, Diagonal ↘.
Where to find it
Gutenberg inserter → Effects → search “Parallax Section” (block name `blockenberg/parallax-section` in block.json). Style it in the sidebar after insert.
How to use Parallax Section block for WordPress
- Install Blockenberg. Install from WordPress.org and activate the plugin.
- Insert the block. Edit a page, click +, search for “Parallax Section”, insert it. Category: Effects.
- Configure inspector controls that exist on this block. Open Background Image. Set “Background Size”, “Background Position”, “Background Blur (px)”, “Fixed Background (no parallax)”.
- Check the published page. The view script reads HTML data attributes: data-parallax, data-speed. The block editor preview may not run the same view script.
Inspector controls from this block’s code
| Control | What the code does |
|---|---|
| Background Size | Select control; the chosen value is saved on the block. Options: Cover; Contain; Auto. block.json default: cover. Saved as `bgSize`. |
| Background Position | Select control; the chosen value is saved on the block. Options: Center Center; Top Center; Bottom Center; Center Left; Center Right. block.json default: center center. Saved as `bgPosition`. |
| Background Blur (px) | Numeric range control in the inspector. Range 0–20. block.json default: 0. Saved as `bgBlur`. |
| Fixed Background (no parallax) | On/off toggle in the inspector. Off by default. Saved as `fixedBackground`. |
| Enable Parallax | On/off toggle in the inspector. On by default. Saved as `parallaxEnabled`. |
| Parallax Speed | Numeric range control in the inspector. 0.05 = subtle · 0.5 = medium · 0.9 = strong. Range 0.05–0.9. block.json default: 0.4. Saved as `parallaxSpeed`. |
| Overlay Opacity (%) | Numeric range control in the inspector. Range 0–100. block.json default: 40. Saved as `overlayOpacity`. |
| Gradient Overlay | On/off toggle in the inspector. Off by default. Saved as `overlayGradient`. |
| Direction | Select control; the chosen value is saved on the block. Options: Top → Bottom; Bottom → Top; Left → Right; Right → Left; Diagonal ↘; Diagonal ↗. block.json default: to bottom. Saved as `overlayGradientDir`. |
| Min Height (px) | Numeric range control in the inspector. Range 100–1200. block.json default: 500. Saved as `minHeight`. |
| Padding Top | Numeric range control in the inspector. Range 0–300. block.json default: 80. Saved as `paddingTop`. |
| Padding Bottom | Numeric range control in the inspector. Range 0–300. block.json default: 80. Saved as `paddingBottom`. |
| Padding Left | Numeric range control in the inspector. Range 0–200. block.json default: 24. Saved as `paddingLeft`. |
| Padding Right | Numeric range control in the inspector. Range 0–200. block.json default: 24. Saved as `paddingRight`. |
| Content Max Width (px) | Numeric range control in the inspector. Range 200–1600. block.json default: 800. Saved as `contentMaxWidth`. |
| Horizontal Align | Select control; the chosen value is saved on the block. Options: Left; Center; Right. block.json default: center. Saved as `contentAlign`. |
| Vertical Align | Select control; the chosen value is saved on the block. Options: Top; Middle; Bottom. block.json default: center. Saved as `contentVAlign`. |
| Border Radius (px) | Numeric range control in the inspector. Range 0–80. block.json default: 0. Saved as `borderRadius`. |
| Background Fallback Color | Color control in the inspector. block.json default: #1e1e1e. Saved as `bgColor`. |
| Overlay Color | Color control in the inspector. block.json default: #000000. Saved as `overlayColor`. |
| Overlay Gradient Start | Color control in the inspector. block.json default: #000000. Saved as `overlayGradientStart`. |
| Overlay Gradient End | Color control in the inspector. block.json default: transparent. Saved as `overlayGradientEnd`. |
| Content Text Color | Color control in the inspector. block.json default: #ffffff. Saved as `textColor`. |
What the front-end script actually does
- The view script reads HTML data attributes: data-parallax, data-speed.
When this is the right block
- A full-width content section with a background image that scrolls at a different speed for a depth parallax effect — that is the job of Parallax Section, not a generic content block.
- Use it when you need the editor control labeled “Background Size”, which exists on this block’s inspector.
- It matches pages about parallax, section, background.
- Inserter grouping: motion, overlays, and visual treatments.
Notes from the implementation
viewScript: this folder’s frontend.js is enqueued on the front end for this block.
FAQ
How do I add the Parallax Section block in WordPress?
Install Blockenberg from WordPress.org, edit a page in the block editor, click +, and search for “Parallax Section”. It sits under Effects. After insert, open Background Image and set “Background Size”, “Background Position”, “Background Blur (px)”, “Fixed Background (no parallax)”.
What makes Parallax Section different from other Blockenberg blocks?
A full-width content section with a background image that scrolls at a different speed for a depth parallax effect. Inspector labels on this block include “Background Size”, “Background Position”, “Background Blur (px)”, “Fixed Background (no parallax)”.
Is the Parallax Section Gutenberg block free?
Yes. Parallax Section ships inside Blockenberg. Get the plugin from WordPress.org — no paid add-on is required for this block.
Can I style Parallax Section to match my theme?
Yes. Blockenberg’s shared typography and color panels apply here, plus any block-specific style controls listed on this page (panels: Background Image, Parallax Effect, Overlay, Layout).
Related effects blocks
Gradient Blob
Full-width section with animated CSS gradient blobs as background and InnerBlocks for content.
Parallax Depth Cards
Cards with layered 3D depth parallax on mouse move — different elements float at different speeds.
Scrollytelling
Sticky background or image that updates as the user scrolls through text chapters.
Sticky Scroll
Apple-style storytelling layout: one column stays pinned while the opposite column scrolls through feature panels.
3D Text
Eye-catching 3D extruded text using CSS text-shadow layers and perspective transforms. Supports rotate-on-hover, float animation, and customizable depth, colors and typography.
Animated Text
Heading with animated cycling words — typewriter, fade, slide, or flip effects. Perfect for hero sections.
Get Blockenberg
Install Blockenberg from WordPress.org, then insert Parallax Section from the Gutenberg inserter.