Blog · Gutenberg
Troubleshooting Guide block for WordPress
Structured problem/cause/solution guide with severity levels, search, and multiple layout 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
Structured problem/cause/solution guide with severity levels, search, and multiple layout options.
Inspector panels on this block: Title & Subtitle, Issues (, Display, Severity Colors. Those titles come from index.js, not from a shared template.
Behavior controls: “Severity” options: Critical, High, Medium, Low; “Layout” options: Cards, Compact List; “Display — Style” options: Bordered, Left Accent, Flat.
Where to find it
Gutenberg inserter → Blog → search “Troubleshooting Guide” (block name `blockenberg/troubleshooting-guide` in block.json). Style it in the sidebar after insert.
How to use Troubleshooting Guide block for WordPress
- Install Blockenberg. Install from WordPress.org and activate the plugin.
- Insert the block. Edit a page, click +, search for “Troubleshooting Guide”, insert it. Category: Blog.
- Configure inspector controls that exist on this block. Open Title & Subtitle. Set “Show Title”, “Title & Subtitle — Title”, “Show Subtitle”, “Subtitle”.
- Check the published page. The view script reads HTML data attributes: data-opts, data-rendered, data-search-text. The block editor preview may not run the same view script.
Inspector controls from this block’s code
| Control | What the code does |
|---|---|
| Show Title | On/off toggle in the inspector. On by default. Saved as `showTitle`. |
| Title & Subtitle — Title | Text field in the inspector. block.json default: Troubleshooting Guide. Saved as `blockTitle`. |
| Show Subtitle | On/off toggle in the inspector. On by default. Saved as `showSubtitle`. |
| Subtitle | Text field in the inspector. block.json default: Find solutions to common issues below.. Saved as `blockSubtitle`. |
| Problem | Text field in the inspector. Saved as `issues`. |
| Cause | Text field in the inspector. Saved as `issues`. |
| Severity | Select control; the chosen value is saved on the block. Options: Critical; High; Medium; Low. Saved as `issues`. |
| Layout | Select control; the chosen value is saved on the block. Options: Cards; Compact List. block.json default: cards. Saved as `layout`. |
| Display — Style | Select control; the chosen value is saved on the block. Options: Bordered; Left Accent; Flat. block.json default: bordered. Saved as `style`. |
| Show Cause Column | On/off toggle in the inspector. On by default. Saved as `showCause`. |
| Show Severity Badges | On/off toggle in the inspector. On by default. Saved as `showSeverity`. |
| Show Numbers | On/off toggle in the inspector. On by default. Saved as `showNumbers`. |
| Search Bar | On/off toggle in the inspector. On by default. Saved as `enableSearch`. |
| Search Placeholder | Text field in the inspector. block.json default: Search issues…. Saved as `searchPlaceholder`. |
| Collapsible Issues | On/off toggle in the inspector. Off by default. Saved as `collapsible`. |
| Gap Between Issues | Numeric range control in the inspector. Range 4–40. block.json default: 14. Saved as `gap`. |
| Border Radius | Numeric range control in the inspector. Range 0–24. block.json default: 10. Saved as `borderRadius`. |
| Block Background | Color control in the inspector. Saved as `bgColor`. |
| Card Background | Color control in the inspector. block.json default: #ffffff. Saved as `cardBg`. |
| Border Color | Color control in the inspector. block.json default: #e2e8f0. Saved as `borderColor`. |
| Title Color | Color control in the inspector. block.json default: #0f172a. Saved as `titleColor`. |
| Problem Color | Color control in the inspector. block.json default: #1e293b. Saved as `problemColor`. |
| Cause Color | Color control in the inspector. block.json default: #475569. Saved as `causeColor`. |
| Solution Text Color | Color control in the inspector. block.json default: #374151. Saved as `solutionColor`. |
| Solution Background | Color control in the inspector. block.json default: #f0fdf4. Saved as `solutionBg`. |
| Critical Background | Color control in the inspector. block.json default: #fee2e2. Saved as `criticalBg`. |
| Critical Text | Color control in the inspector. block.json default: #991b1b. Saved as `criticalColor`. |
| High Background | Color control in the inspector. block.json default: #ffedd5. Saved as `highBg`. |
| High Text | Color control in the inspector. block.json default: #9a3412. Saved as `highColor`. |
| Medium Background | Color control in the inspector. block.json default: #fef9c3. Saved as `mediumBg`. |
| Medium Text | Color control in the inspector. block.json default: #854d0e. Saved as `mediumColor`. |
| Low Background | Color control in the inspector. block.json default: #f0fdf4. Saved as `lowBg`. |
| Low Text | Color control in the inspector. block.json default: #166534. Saved as `lowColor`. |
What the front-end script actually does
- The view script reads HTML data attributes: data-opts, data-rendered, data-search-text.
When this is the right block
- Structured problem/cause/solution guide with severity levels, search, and multiple layout options — that is the job of Troubleshooting Guide, not a generic content block.
- Use it when you need the editor control labeled “Show Title”, which exists on this block’s inspector.
- It matches pages about troubleshooting, problem, solution.
- 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 Troubleshooting Guide block in WordPress?
Install Blockenberg from WordPress.org, edit a page in the block editor, click +, and search for “Troubleshooting Guide”. It sits under Blog. After insert, open Title & Subtitle and set “Show Title”, “Title & Subtitle — Title”, “Show Subtitle”, “Subtitle”.
What makes Troubleshooting Guide different from other Blockenberg blocks?
Structured problem/cause/solution guide with severity levels, search, and multiple layout options. Inspector labels on this block include “Show Title”, “Title & Subtitle — Title”, “Show Subtitle”, “Subtitle”.
Is the Troubleshooting Guide Gutenberg block free?
Yes. Troubleshooting Guide ships inside Blockenberg. Get the plugin from WordPress.org — no paid add-on is required for this block.
Can I style Troubleshooting Guide 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: Title & Subtitle, Issues (, Display, Severity Colors).
Related blog blocks
Knowledge Base Article
Full knowledge base / help center article with category, difficulty, table of contents, sections, and related articles.
Chapter Navigation
Multi-part guide and series navigation with progress, prev/next, and chapter list.
Glossary
A–Z alphabetical glossary / dictionary with a clickable alphabet navigation bar, terms grouped by first letter, and expandable or always-visible definitions.
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.
Lesson Objectives
"What You'll Learn" educational objectives box with bullet points, level badge, and estimated read time.
Salary Guide
Display salary ranges by role and level with visual min/max bars and median markers.
Get Blockenberg
Install Blockenberg from WordPress.org, then insert Troubleshooting Guide from the Gutenberg inserter.