Blog · Gutenberg
Chapter Navigation block for WordPress
Multi-part guide and series navigation with progress, prev/next, and chapter list.
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
Multi-part guide and series navigation with progress, prev/next, and chapter list.
Inspector panels on this block: Series Info, Prev / Next, Chapter List, Style & Layout. Those titles come from index.js, not from a shared template.
Behavior controls: “Style & Layout — Style” options: Card (bordered box), Banner (left accent), Minimal (top line).
Where to find it
Gutenberg inserter → Blog → search “Chapter Navigation” (block name `blockenberg/chapter-navigation` in block.json). Style it in the sidebar after insert.
How to use Chapter Navigation block for WordPress
- Install Blockenberg. Install from WordPress.org and activate the plugin.
- Insert the block. Edit a page, click +, search for “Chapter Navigation”, insert it. Category: Blog.
- Configure inspector controls that exist on this block. Open Series Info. Set “Series Title”, “Current Chapter Title”, “Part Label”, “Current Part”.
- Check the published page. The view script reads HTML data attributes: data-opts, data-rendered. The block editor preview may not run the same view script.
Inspector controls from this block’s code
| Control | What the code does |
|---|---|
| Series Title | Text field in the inspector. block.json default: Complete Guide to SEO. Saved as `seriesTitle`. |
| Current Chapter Title | Text field in the inspector. block.json default: On-Page Optimization. Saved as `currentTitle`. |
| Part Label | Text field in the inspector. block.json default: Part. Saved as `partLabel`. |
| Current Part | Numeric range control in the inspector. block.json default: 3. Saved as `currentPart`. |
| Total Parts | Numeric range control in the inspector. Range 1–50. block.json default: 7. Saved as `totalParts`. |
| Previous Chapter Title | Text field in the inspector. block.json default: Keyword Research. Saved as `prevTitle`. |
| Previous URL | Text field in the inspector. Saved as `prevUrl`. |
| Next Chapter Title | Text field in the inspector. block.json default: Technical SEO. Saved as `nextTitle`. |
| Next URL | Text field in the inspector. Saved as `nextUrl`. |
| Show All Chapters List | On/off toggle in the inspector. On by default. Saved as `showChapterList`. |
| Open List by Default | On/off toggle in the inspector. Off by default. Saved as `chapterListOpen`. |
| Style & Layout — Style | Select control; the chosen value is saved on the block. Options: Card (bordered box); Banner (left accent); Minimal (top line). block.json default: card. Saved as `style`. |
| Show Progress Bar | On/off toggle in the inspector. On by default. Saved as `showProgress`. |
| Open Links in New Tab | On/off toggle in the inspector. Off by default. Saved as `openInNewTab`. |
| Border Radius | Numeric range control in the inspector. Range 0–24. block.json default: 10. Saved as `borderRadius`. |
| Padding Top | Numeric range control in the inspector. Range 0–120. block.json default: 0. Saved as `paddingTop`. |
| Padding Bottom | Numeric range control in the inspector. Range 0–120. block.json default: 0. Saved as `paddingBottom`. |
| Series Title Size (px) | Numeric range control in the inspector. Range 10–20. block.json default: 13. Saved as `seriesTitleFontSize`. |
| Nav Button Size (px) | Numeric range control in the inspector. Range 10–20. block.json default: 13. Saved as `navFontSize`. |
| Chapter List Size (px) | Numeric range control in the inspector. Range 10–20. block.json default: 13. Saved as `chapterListFontSize`. |
| Colors — Background | Color control in the inspector. block.json default: #ffffff. Saved as `bgColor`. |
| Colors — Border | Color control in the inspector. block.json default: #e2e8f0. Saved as `borderColor`. |
| Accent | Color control in the inspector. block.json default: #6366f1. Saved as `accentColor`. |
| Series Title | Color control in the inspector. block.json default: #374151. Saved as `seriesTitleColor`. |
| Current Title | Color control in the inspector. block.json default: #111827. Saved as `currentTitleColor`. |
| Progress Bar BG | Color control in the inspector. block.json default: #e2e8f0. Saved as `progressBg`. |
| Progress Fill | Color control in the inspector. block.json default: #6366f1. Saved as `progressFill`. |
| Nav Button BG | Color control in the inspector. block.json default: #f1f5f9. Saved as `btnBg`. |
| Nav Button Text | Color control in the inspector. block.json default: #374151. Saved as `btnColor`. |
| Pill BG | Color control in the inspector. block.json default: #eef2ff. Saved as `pillBg`. |
| Pill Text | Color control in the inspector. block.json default: #4f46e5. Saved as `pillColor`. |
| Chapter List BG | Color control in the inspector. block.json default: #f8fafc. Saved as `chapterListBg`. |
| Active Chapter BG | Color control in the inspector. block.json default: #eef2ff. Saved as `activeChapterBg`. |
| Active Chapter Text | Color control in the inspector. block.json default: #4f46e5. Saved as `activeChapterColor`. |
What the front-end script actually does
- The view script reads HTML data attributes: data-opts, data-rendered.
When this is the right block
- Multi-part guide and series navigation with progress, prev/next, and chapter list — that is the job of Chapter Navigation, not a generic content block.
- Use it when you need the editor control labeled “Series Title”, which exists on this block’s inspector.
- It matches pages about chapter, navigation, series.
- Inserter grouping: posts, magazines, and editorial WordPress pages.
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 Chapter Navigation block in WordPress?
Install Blockenberg from WordPress.org, edit a page in the block editor, click +, and search for “Chapter Navigation”. It sits under Blog. After insert, open Series Info and set “Series Title”, “Current Chapter Title”, “Part Label”, “Current Part”.
What makes Chapter Navigation different from other Blockenberg blocks?
Multi-part guide and series navigation with progress, prev/next, and chapter list. Inspector labels on this block include “Series Title”, “Current Chapter Title”, “Part Label”, “Current Part”.
Is the Chapter Navigation Gutenberg block free?
Yes. Chapter Navigation ships inside Blockenberg. Get the plugin from WordPress.org — no paid add-on is required for this block.
Can I style Chapter Navigation 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: Series Info, Prev / Next, Chapter List, Style & Layout).
Related blog blocks
Article Series
Multi-part series navigator showing all articles with the current one highlighted and progress indicator.
Table of Contents
Auto-generated table of contents from headings on the page, with smooth scroll and active-link highlighting.
Category Grid
Display WordPress post categories in a responsive grid with post counts, icons, descriptions, and rich styling options.
Content Outline
Structured article outline with numbered sections, sub-points, optional status badges, and estimated reading time.
HowTo Schema
Step-by-step How-To guide with automatic Schema.org HowTo JSON-LD structured data for Google rich results. Includes supplies, tools, total time, cost estimate, and numbered steps with images.
Knowledge Base Article
Full knowledge base / help center article with category, difficulty, table of contents, sections, and related articles.
Get Blockenberg
Install Blockenberg from WordPress.org, then insert Chapter Navigation from the Gutenberg inserter.