BugWP logo BugWP
Back to Community
Home / Community / Plugin → Spectra gutenberg blocks – website builder for the block editor

Troubleshooting Common Spectra FAQ Block Issues: From Broken Layouts to Missing Schema

32 threads Sep 16, 2025 Plugin → Spectra gutenberg blocks – website builder for the block editor

Content

The Spectra FAQ block is a powerful tool for creating interactive, SEO-friendly content. However, like any complex feature, users can sometimes encounter issues that prevent it from working correctly on their live websites. Based on common community reports, this guide outlines the most frequent problems and their solutions.

Common Spectra FAQ Block Issues and Solutions

1. FAQ Block is Broken or Unclickable on the Live Site

The Problem: The FAQ block works perfectly in the WordPress editor, but on the front end, the questions won't expand or the layout appears broken.

Why It Happens: This is almost always a conflict with optimization or caching plugins that combine or minify JavaScript files. This process can break the specific scripts that control the FAQ block's interactivity.

The Solution:

  • Identify any caching, optimization, or speed-focused plugins on your site (e.g., WP Rocket, W3 Total Cache, Autoptimize).
  • Temporarily disable the plugin's JavaScript optimization features, specifically JavaScript Combination or Minification.
  • Clear all your site and browser caches.
  • Test your page again. If it works, you can often re-enable other optimizations while leaving JS combination off for the specific scripts that conflict. You may need to add an exclusion for Spectra's scripts within your optimization plugin's settings.

2. FAQ Schema Markup is Missing or Not Updating

The Problem: Google's Rich Results Test or Schema validator does not detect the FAQ schema, or the schema does not update after you modify your questions and answers.

Why It Happens: This can be caused by caching, either at the plugin level or on your server. The schema is generated when the page is saved, but cached versions of the page might be serving the old, unupdated code.

The Solution:

  • First, ensure the schema is enabled: In the FAQ block's settings, make sure the 'Schema Support' toggle is switched on.
  • Regenerate Assets: Navigate to Spectra Settings → Dashboard (wp-admin → Settings → Spectra) and click the 'Regenerate Assets' button. This refreshes the plugin's core files.
  • Clear All Caches: Thoroughly clear any site cache (from your caching plugin) and server-level cache (if applicable, like from Cloudflare).
  • Re-test your page using the Schema Markup Validator.

3. Unable to Add Lists, Images, or Custom HTML in Answers

The Problem: The FAQ block only allows basic text and paragraph tags. Attempting to paste a list (<ul>, <ol>, <li>) or edit the HTML directly results in an error or the content being stripped out.

Why It Happens: This is a current limitation of the Spectra FAQ block's design. It does not natively support inner blocks or more complex HTML elements within the answer field.

The Solution:

  • There is no direct workaround within the block itself. This is a known feature request that the Spectra team has acknowledged and may address in a future update.
  • As an alternative, consider using a different Spectra block, such as the Accordion block, if it offers the flexibility you need, or place your detailed content with lists and images below the FAQ block.

4. Layout and Spacing Issues When Expanded

The Problem: When an answer is expanded, an extra margin or padding appears, creating a larger than desired gap between FAQs. This often occurs after a theme or plugin update.

Why It Happens: Updates can change the underlying HTML structure or CSS classes of the block. If your theme has custom CSS that targets these specific classes, the styles may break or double up. For example, a theme might apply a margin to all paragraph (<p>) tags, and an update might have changed the answer's container to use a <p> tag instead of a <div>.

The Solution:

  • Identify the CSS causing the extra space using your browser's inspector tool (right-click on the space and select "Inspect").
  • Add custom CSS to your theme (under Appearance → Customize → Additional CSS) to override the problematic margin or padding. You may need to target the specific Spectra class, such as .uagb-faq__content.

Conclusion

Most issues with the Spectra FAQ block can be resolved by checking for conflicts with optimization plugins and ensuring all caches are cleared. For functionality limitations like adding rich content inside answers, users have submitted feature requests, and the Spectra team is aware of the demand for these improvements. Always ensure your Spectra plugin and WordPress theme are updated to the latest versions to benefit from bug fixes and compatibility patches.

Related Support Threads Support