Layout · Gutenberg
Page Header block for WordPress
A versatile page hero/banner section: eyebrow label, headline, subtitle, breadcrumbs, CTA buttons, and rich background options.
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 versatile page hero/banner section: eyebrow label, headline, subtitle, breadcrumbs, CTA buttons, and rich background options.
Inspector panels on this block: Style & Layout, Content. Those titles come from index.js, not from a shared template.
Behavior controls: “Style & Layout — Style” options: Centered, Left-aligned, Split (text+bg), Minimal, Dark hero; “Background type” options: Solid color, Gradient, Image; “Text alignment” options: Left, Center, Right.
Page Header has no render.php and no frontend.js. The saved Gutenberg HTML is what visitors see, plus Blockenberg layout/typography CSS.
Where to find it
Gutenberg inserter → Layout → search “Page Header” (block name `blockenberg/page-header` in block.json). Style it in the sidebar after insert.
How to use Page Header block for WordPress
- Install Blockenberg. Install from WordPress.org and activate the plugin.
- Insert the block. Edit a page, click +, search for “Page Header”, insert it. Category: Layout.
- Configure inspector controls that exist on this block. Open Style & Layout. Set “Style & Layout — Style”, “Background type”, “Overlay opacity (%)”, “Text alignment”.
- Publish. Save the page. Output is the saved block HTML; typography/colors follow Blockenberg shared panels.
Inspector controls from this block’s code
| Control | What the code does |
|---|---|
| Style & Layout — Style | Select control; the chosen value is saved on the block. Options: Centered; Left-aligned; Split (text+bg); Minimal; Dark hero. block.json default: centered. Saved as `style`. |
| Background type | Select control; the chosen value is saved on the block. Options: Solid color; Gradient; Image. block.json default: color. Saved as `bgType`. |
| Overlay opacity (%) | Numeric range control in the inspector. Range 0–100. block.json default: 55. Saved as `bgOverlayOpacity`. |
| Text alignment | Select control; the chosen value is saved on the block. Options: Left; Center; Right. block.json default: center. Saved as `textAlign`. |
| Content max-width (px) | Numeric range control in the inspector. Range 400–1400. block.json default: 760. Saved as `contentMaxWidth`. |
| Show eyebrow | On/off toggle in the inspector. On by default. Saved as `showEyebrow`. |
| Show subtitle | On/off toggle in the inspector. On by default. Saved as `showSubtitle`. |
| Show breadcrumbs | On/off toggle in the inspector. Off by default. Saved as `showBreadcrumbs`. |
| Primary button | On/off toggle in the inspector. On by default. Saved as `showPrimaryBtn`. |
| Primary label | Text field in the inspector. block.json default: Get Started. Saved as `primaryLabel`. |
| Primary URL | Text field in the inspector. block.json default: #. Saved as `primaryUrl`. |
| Secondary button | On/off toggle in the inspector. On by default. Saved as `showSecondaryBtn`. |
| Secondary label | Text field in the inspector. block.json default: Learn More. Saved as `secondaryLabel`. |
| Secondary URL | Text field in the inspector. block.json default: #. Saved as `secondaryUrl`. |
| Padding top (px) | Numeric range control in the inspector. Range 0–240. block.json default: 100. Saved as `paddingTop`. |
| Padding bottom (px) | Numeric range control in the inspector. Range 0–240. block.json default: 100. Saved as `paddingBottom`. |
| Button radius (px) | Numeric range control in the inspector. Range 0–50. block.json default: 50. Saved as `btnRadius`. |
| Background color | Color control in the inspector. block.json default: #f8f5ff. Saved as `bgColor`. |
| Overlay color | Color control in the inspector. block.json default: #0f172a. Saved as `bgOverlayColor`. |
| Eyebrow bg | Color control in the inspector. block.json default: #ede9fe. Saved as `eyebrowBg`. |
| Eyebrow text | Color control in the inspector. block.json default: #6c3fb5. Saved as `eyebrowColor`. |
| Headline | Color control in the inspector. block.json default: #1e293b. Saved as `headlineColor`. |
| Subtitle | Color control in the inspector. block.json default: #64748b. Saved as `subtitleColor`. |
| Primary btn bg | Color control in the inspector. block.json default: #6c3fb5. Saved as `primaryBtnBg`. |
| Primary btn text | Color control in the inspector. block.json default: #ffffff. Saved as `primaryBtnColor`. |
| Secondary btn text | Color control in the inspector. block.json default: #6c3fb5. Saved as `secBtnColor`. |
| Breadcrumb color | Color control in the inspector. block.json default: #94a3b8. Saved as `breadcrumbColor`. |
When this is the right block
- A versatile page hero/banner section: eyebrow label, headline, subtitle, breadcrumbs, CTA buttons, and rich background options — that is the job of Page Header, not a generic content block.
- Use it when you need the editor control labeled “Style & Layout — Style”, which exists on this block’s inspector.
- It matches pages about hero, banner, page header.
- Inserter grouping: page structure, sections, and composition.
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 Page Header block in WordPress?
Install Blockenberg from WordPress.org, edit a page in the block editor, click +, and search for “Page Header”. It sits under Layout. After insert, open Style & Layout and set “Style & Layout — Style”, “Background type”, “Overlay opacity (%)”, “Text alignment”.
What makes Page Header different from other Blockenberg blocks?
A versatile page hero/banner section: eyebrow label, headline, subtitle, breadcrumbs, CTA buttons, and rich background options. Inspector labels on this block include “Style & Layout — Style”, “Background type”, “Overlay opacity (%)”, “Text alignment”.
Is the Page Header Gutenberg block free?
Yes. Page Header ships inside Blockenberg. Get the plugin from WordPress.org — no paid add-on is required for this block.
Can I style Page Header 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: Style & Layout, Content).
Related layout blocks
Dark Hero
Dark glassmorphism hero for AI, SaaS and tech sites. Features glow effects, gradient text, optional floating stat badges, badge pill, and rich button controls.
Gradient Hero
Full landing page hero with animated gradient/mesh background, badge, headline, CTA buttons, and social proof row.
Gradient Section
A full-width section with an animated CSS gradient background, headline, subtext, and dual call-to-action buttons.
Skewed Section
A content section with diagonal/angled top and/or bottom edges created via CSS clip-path. Place any blocks inside.
Split Hero
Two-column hero section with headline, badge, body text, dual CTA buttons and social proof on one side — image or video on the other. Built for landing pages.
Split Screen
Two-panel side-by-side layout with independent backgrounds, content, and optional scroll-snap.
Get Blockenberg
Install Blockenberg from WordPress.org, then insert Page Header from the Gutenberg inserter.