Blog · Gutenberg
Reading Progress block for WordPress
A fixed reading progress bar that fills as the visitor scrolls.
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 fixed reading progress bar that fills as the visitor scrolls.
Inspector panels on this block: Position & Size, Appearance, Bar Colors. Those titles come from index.js, not from a shared template.
Behavior controls: “Position” options: Top of viewport, Bottom of viewport; “Animation” options: Smooth, None.
Where to find it
Gutenberg inserter → Blog → search “Reading Progress” (block name `blockenberg/reading-progress` in block.json). Style it in the sidebar after insert.
How to use Reading Progress block for WordPress
- Install Blockenberg. Install from WordPress.org and activate the plugin.
- Insert the block. Edit a page, click +, search for “Reading Progress”, insert it. Category: Blog.
- Configure inspector controls that exist on this block. Open Position & Size. Set “Position”, “Bar Height (px)”, “Z-Index”, “Animation”.
- Check the published page. The view script reads HTML data attributes: data-label-typo, data-position. The block editor preview may not run the same view script.
Inspector controls from this block’s code
| Control | What the code does |
|---|---|
| Position | Select control; the chosen value is saved on the block. Options: Top of viewport; Bottom of viewport. block.json default: top. Saved as `position`. |
| Bar Height (px) | Numeric range control in the inspector. Range 1–20. block.json default: 4. Saved as `height`. |
| Z-Index | Numeric range control in the inspector. Range 100–99999. block.json default: 9999. Saved as `zIndex`. |
| Animation | Select control; the chosen value is saved on the block. Options: Smooth; None. block.json default: smooth. Saved as `animation`. |
| Use gradient color | On/off toggle in the inspector. Off by default. Saved as `useGradient`. |
| Show percentage label | On/off toggle in the inspector. Off by default. Saved as `showPercentage`. |
| Percentage Label | Shared Blockenberg typography popover (family, size, weight, spacing). Saved as `labelTypo`. |
| Progress Color | Color control in the inspector. block.json default: #2563eb. Saved as `color`. |
| Gradient End | Color control in the inspector. Saved as `gradientEnd`. |
| Background Track | Color control in the inspector. block.json default: #e5e7eb. Saved as `bgColor`. |
What the front-end script actually does
- The view script reads HTML data attributes: data-label-typo, data-position.
When this is the right block
- A fixed reading progress bar that fills as the visitor scrolls — that is the job of Reading Progress, not a generic content block.
- Use it when you need the editor control labeled “Position”, which exists on this block’s inspector.
- It matches pages about progress, reading, scroll.
- 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 Reading Progress block in WordPress?
Install Blockenberg from WordPress.org, edit a page in the block editor, click +, and search for “Reading Progress”. It sits under Blog. After insert, open Position & Size and set “Position”, “Bar Height (px)”, “Z-Index”, “Animation”.
What makes Reading Progress different from other Blockenberg blocks?
A fixed reading progress bar that fills as the visitor scrolls. Inspector labels on this block include “Position”, “Bar Height (px)”, “Z-Index”, “Animation”.
Is the Reading Progress Gutenberg block free?
Yes. Reading Progress ships inside Blockenberg. Get the plugin from WordPress.org — no paid add-on is required for this block.
Can I style Reading Progress 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: Position & Size, Appearance, Bar Colors).
Related blog blocks
Article Series
Multi-part series navigator showing all articles with the current one highlighted and progress indicator.
Book Shelf
A visual reading list with a realistic bookshelf view, cards layout, or list — complete with ratings, reading status, and genre tags.
Horizontal Timeline
Horizontal scrolling timeline with draggable track, alternating items above/below the line, animated entry, and rich styling options.
Link Roundup
Curated links collection — weekly/monthly digest with categories.
Reading Card
Book, article, podcast or course recommendation card with cover image, rating, category badge and CTA link. Multiple visual styles.
Reading List
Curated book or article reading list with cover image, title, author, genre, star rating, read-status badge (Reading / Read / Want to Read / Recommended), description, and optional link.
Get Blockenberg
Install Blockenberg from WordPress.org, then insert Reading Progress from the Gutenberg inserter.