Docs
← Back to site

WP Super Docs: Changelog

2026

Nov 6
Improved

1.0.15

Translations

  • Translation slugs. New setting under Settings → Integrations → Connect Claude (MCP) → Translation slugs, shown on WPML and Polylang sites. When Claude translates a doc, category or product, the translation now keeps the original’s slug by default, so the Arabic version of /docs/help-center/getting-started/installing/ is /ar/docs/help-center/getting-started/installing/. Choose From the translated title for the old behavior. A slug you ask Claude for still wins, and a slug that isn’t in Latin letters is never copied to other languages.
  • Translated categories and products keep the original’s slug. They no longer end up as getting-started-2 on WPML sites, because they are now created in their own language.
  • Fix a translation’s slug. Claude can change the slug of a translated category or product, for example from getting-started-2 to getting-started. Sidebar and docs homepage settings move with a renamed product. The slugs of categories and products in your main language can still only be changed in WordPress.
  • Warning when a slug changes. If WordPress gives a translation a different slug than the one asked for, Claude now tells you, with the address it got. For a draft, Claude tells you before it is published.

Page caching

  • Docs pages can be cached. Docs pages no longer tell page caches and CDNs (xSpeed, WP Rocket, LiteSpeed, Cloudflare and others) not to store them, so they load from the cache like the rest of your site.
  • The cache clears itself when your docs change. Publishing, unpublishing or renaming a doc, moving it to another category, editing a category or product, changing the sidebar order or a WP Super Docs setting now clears the page cache once, through xSpeed, WP Rocket, LiteSpeed Cache, W3 Total Cache, WP Super Cache, SiteGround Optimizer, Cache Enabler or Breeze. Editing a doc’s text leaves the clearing of that page to your cache plugin, as before.
  • Per-visitor pages stay out of the cache. The roadmap (it shows each visitor’s own votes) and docs pages built from a visitor’s chosen version are still never stored. A visitor who picked another version and is served a cached page is taken to that version’s page.
  • “Was this helpful?” works on cached pages. If a cached page’s security token has expired, the vote now gets a fresh one and goes through.
Nov 6
1.0.14
New

1.0.14

Share images for every page, SEO that works with your SEO plugin instead of against it, and a much more capable Claude connection: translations, the roadmap, snippets, videos, site screenshots and release checks. Plus one-token Cloudflare setup, with the option to run Ask AI on a Cloudflare Worker.

New: share images

  • A share image for every page type. Under Settings → SEO → Share images, pick the image shown when a page is shared on Facebook, X, LinkedIn or Slack: a site-wide default, the docs homepage, products, categories, the Docs Updates page, the changelogs, the roadmap, feature requests, shipped items and the 404 page.
  • One per language for the docs homepage on WPML and Polylang sites.
  • Per product and per category, from the product or category edit screen.
  • Order used: the category’s or product’s own image, then the page type’s image, then the product’s, then the default. A doc uses its featured image; the default is only used when a doc has no image of its own.

SEO

  • Works with your SEO plugin. Generated pages (docs homepage, products, categories, changelogs, roadmap) now print one of each tag, with the right title, description, address and image, on Slim SEO, The SEO Framework, AIOSEO, SEOPress, SureRank, Yoast SEO and Rank Math, and with no SEO plugin at all.
  • A doc’s own SEO image wins. An image set for a doc in Slim SEO, Yoast, Rank Math, SEOPress or AIOSEO is no longer replaced by the default share image.
  • Changelog pages now have their own title, description and share tags.

New: Claude can do more (MCP)

  • Translate docs. On WPML and Polylang sites, Claude creates the translated doc, linked to the original, in the right product and category for that language, and writes the translated content, SEO and slug in the same step. Docs show their language and which translations are missing.
  • Create and edit categories and products, including their description, SEO title and description, icon, sidebar position and share image. Categories and products can be created as translations of existing ones.
  • The roadmap. Claude can list roadmap items and feature requests, add items, change their status, write the team response, link the changelog entry and docs that cover an item, and merge duplicate requests (their votes are added together). Submitter names and emails are never shown to Claude.
  • Snippets. Claude can list your snippets, create new ones, and use them in docs with a line instead of repeating the same text.
  • Sidebar order. Claude can read a product’s sidebar as visitors see it and move categories and docs (administrators only).
  • Retire outdated docs, with your approval. Claude can only ask. The request appears at the top of the WP Super Docs admin screens with the reason and the replacement doc; approving it moves the doc to the trash and redirects its address. Restoring the doc removes the redirect. Claude also gets a list of docs that link to it, so it can fix them.
  • Check before saving. check_markdown finds missing images, videos and snippets, links to docs that don’t exist or aren’t published, code blocks without a language, skipped heading levels and leftover placeholders, without saving anything.
  • Release check. release_check lists every doc added or changed since your last changelog entry and what each still needs (SEO, share image, badge, publishing, review, translations), plus roadmap items shipped without a changelog entry.
  • Videos. With Nahnu Video for Bunny Stream active, Claude can find videos in your library and put a video, grid or playlist in a doc, or write ![Title](video:ID) in Markdown.
  • Screenshots of your site. Turn on Screenshots of your site under Connect Claude. Claude gets a one-time link that opens a page logged out, or logged in as a “Claude Viewer” account, so it can capture members-only pages. Give that account a membership level in any membership plugin. The Viewer can only look: no password sign-in, no dashboard, no forms. Links work once, within two minutes.
  • Images: upload up to 25 images with one link (the link stays open for any that didn’t arrive), change an image’s alt text, title or caption, and page through the Media Library.
  • Share images and term SEO can be set by Claude too.

New: Cloudflare setup with one token

Optional, under Settings → Integrations → Cloudflare setup:

  • R2 storage in one click. Paste a Cloudflare API token, pick one of your domains, and WP Super Docs creates the R2 bucket for the docs index, connects your chosen address, fills in Index storage and pushes the index.
  • Ask AI on a Cloudflare Worker. One more click deploys a Worker that answers Ask AI with your current AI provider, model and key, reading the docs index straight from R2. Questions no longer reach your server, so heavy use and bots can’t slow it down. If the Worker can’t be reached, Ask AI answers from WordPress as before. Changing your AI settings updates the Worker automatically.
  • Everything is named after your site (for example yoursite-com-wpsuperdocs) so it’s easy to find in Cloudflare.

Security and permissions

  • Changes Claude makes to things visitors already see (roadmap items, snippets, the sidebar, category and product text) follow the same rule as published docs: they only go live straight away when your site allows it.
  • Creating categories and products and changing the sidebar order need an administrator, the same as the admin screens.
  • Retiring a doc always needs a person’s approval.

Fixes

  • RunCloud sign-in fix narrowed. The nginx lines from Test connection now only cover WP Super Docs’ own sign-in addresses. The earlier lines also caught other plugins’ addresses, so other MCP servers on the same site couldn’t connect. If you added these lines before, replace them with the new ones.
  • Snippet variables ({{name}}) were never filled in. They now are, in any letter case.
  • Callouts had stray paragraph tags, and a video or snippet inside a callout got extra line breaks.
  • Generated pages could show the same Open Graph and canonical tags twice when an SEO plugin was active.
  • The SEO Framework showed “Untitled” as the share title on the docs homepage, and showed & in browser tabs for names with an ampersand.
  • A category page could point its canonical address at another product.
  • Pages 2 and later of the changelogs pointed their canonical address at page 1.
  • Docs with custom SEO settings printed two canonical links when no SEO plugin was active, and docs without a description lost their share image.

Docs

  • New: Share Images, Cloudflare Setup: R2 Storage and Ask AI on a Worker and Screenshots of Your Site with Claude.
  • Updated: Connecting Claude to Your Docs (MCP), Writing and Illustrating Docs with Claude, Reusable Content Snippets, Open Graph Tags, Setting Up WPML, Setting Up Polylang, Managing the Roadmap Board, Creating and Managing Categories, Creating and Managing Products and What Data Is Sent to AI Providers.
Oct 29
1.0.13
New

1.0.13

New: Connect Claude to your docs (Beta). WP Super Docs now has a built-in MCP server, so Claude can work on your docs with you. Turn it on under Settings → Integrations → Connect Claude (MCP), paste the address into Claude, log in to your site and click Approve. No passwords to copy and no files to edit. Works in Claude on the web, desktop and mobile, and in Claude Code. Off by default.

See: https://www.wpsuperdocs.com/docs/main/mcp-ai-assistants/connecting-claude-to-your-docs-mcp/

What Claude can do. Search and read your docs, write new ones in Markdown, make small exact edits or rewrite a doc, fill in SEO titles and descriptions (in WP Super Docs SEO, Yoast, Rank Math, SEOPress or Slim SEO), set status badges, draft changelog entries, and find what to write next from searches that found nothing and docs readers rated unhelpful.

Images and screenshots. Claude can add images from a web address, a file on your computer or an SVG diagram it draws, and place them in a doc. Give a screenshot a key and upload a new version later: every doc that shows it updates at once.

See: https://www.wpsuperdocs.com/docs/main/mcp-ai-assistants/writing-and-illustrating-docs-with-claude/

You stay in control. Claude works as the WordPress account that approved it and can only do what that account can do. New docs are drafts. Changes to published docs wait as a Proposed update you publish with one click, unless you choose to let them go live right away. Publishing is off until you turn it on. See every connected app, and disconnect any of them, on the settings card or your Profile page.

Test connection. One click checks every step Claude’s connection needs, both through your CDN or firewall and directly on your server, and explains what to change if something is blocked. Includes a fix for nginx servers, such as RunCloud, that hide addresses starting with a dot.

Bunny.net. With Nahnu Cache Connector for Bunny.net active, Claude’s connection passes Bunny Shield and the CDN cache automatically. Nothing to set up.

Nahnu Fonts support. Fonts from Nahnu Fonts now appear in Settings → Appearance → Typography for docs headings and body text. Yabe Webfont, now called Jooosi Fon, is detected under its new name, and older installs keep working.

See: https://www.nahnufonts.com

Fixed: Docs Updates and combined changelog pages. /docs/changelog/ and /docs/product-updates/ could show the docs homepage or a 404 page. They now open correctly.

Fixed: docs homepage. The product switcher now says “Choose a product”, the sidebar no longer says “No docs yet for this product” when no links are pinned, and pages that belong to no product no longer show another product’s sidebar.

Fixed: 404 page. A broken link inside a product now shows that product’s sidebar, and lists in a custom 404 message line up properly.

Fixed: feature requests inbox. Pending requests showed “57 years ago” and sorted wrongly under Trending. They now show the real time they were sent.

Fixed: Doc Categories page. The OpenAPI panel shows the saved spec URL, and each category’s doc count only counts docs in the product you’re viewing.

Fixed: previews. Previewing a new draft opened the category page instead of the doc.

Also improved: cards and link lists no longer pick up the underline meant for links in text; related docs and meta descriptions use the doc’s first paragraph, cut at a whole word; search highlights no longer leave a gap inside a word; nested lists import correctly from Markdown; and dropdowns in the editor sidebar no longer overflow.

Security. The new connection was reviewed independently before release, and content from Claude is always filtered the same way WordPress filters an Author’s posts, whatever the account’s role.

Oct 26
1.0.12
Improved

1.0.12

A cleanup release: no new features

Security and privacy

  • Internal-only docs no longer leak their content. Their content was reachable through built-in search excerpts, the public Ask AI endpoint (quoted in answers), the search index export, Algolia and Elasticsearch, the docs index pushed to R2/Bunny, and the WordPress REST API. Now: logged-out visitors get title and link only in search, the REST API returns an empty body, and the exports and indexes leave internal docs out entirely. Titles stay visible, as documented.
  • Draft versions are now actually hidden. A doc in a draft version could be opened by direct link, ?wpsd_v= or a cookie, and showed up in search and the sitemap. Now it returns 404 for anyone who can’t view that version, the version switch is ignored, and the docs are excluded from search, sitemaps and all indexes. Preview links still work.
  • Ask AI’s rate limit trusted X-Real-IP / CF-Connecting-IP from anyone, so one person could make unlimited paid API calls. Proxy headers are now only honoured behind a real proxy or Cloudflare, and there is a site-wide hourly cap as a backstop.
  • The /summarize endpoint let any Contributor read the AI summary of any doc, including other authors’ drafts. It now requires edit rights on that doc.
  • Version-group link/unlink only checked edit_posts, so a Contributor could relink any post of any type. Now per-doc.
  • The embeddable changelog widget inserted API strings into the host page unescaped (a title with markup would run inside the customer’s app). Everything is escaped now.
  • Feedback votes no longer return raw database error text to visitors; comments are capped at 500 characters server-side; voting is refused when feedback is off.
  • OpenAPI spec fetches now re-validate every redirect hop (a redirect to a private address was followed).
  • The feature-request “minimum fill time” spam check could be skipped by omitting a field.

Things that were broken

  • Sidebar empty for versioned products: the navigation query demanded “in this product AND in no product” whenever versioning was on.
  • Core taxonomy sitemaps fatal: /wp-sitemap-taxonomies-*.xml crashed with a type error when the sitemap feature was on.
  • Docs without a category 404ed at their own URL (the “General” links in the sidebar). The URL’s product/category segments were being applied as filters to the doc query.
  • Unknown product or category gave a blank page instead of the docs 404 page.
  • OpenAPI re-sync was broken: the operation ID was never stored, so a second sync rewrote one doc repeatedly and trashed it. Fixed, and existing generated docs are adopted by title on the first sync after upgrading rather than duplicated.
  • Importers crashed on any per-doc error (TypeError on the error counter), for Intercom, Help Scout, BetterDocs and weDocs.
  • Settings forms wiped each other: saving the Footer tab for one product erased the global footer (and vice versa); saving the General tab turned off OpenAPI; saving changelog page settings turned off the combined changelog; per-language docs-homepage SEO titles were saved under the wrong keys so they never applied.
  • Every plugin update re-enabled the product changelog for sites that had turned it off, and re-ran a “one-time” cleanup.
  • PHP 7.4 compatibility: the plugin says it supports 7.4 but used PHP 8 syntax in three files, which made it fatal on load. Also release.json and the readme still said 1.0.9 / tested 6.8.
  • uninstall.php deleted term relationships with the wrong ID column and did not clean up snippets, services, roadmap items, versions, roadmap statuses, user preferences or the digest cron.
  • Roadmap “Read changelog” links were all 404s (changelog entries have no permalink of their own).
  • The preview-link banner never rendered (its hook was never fired).
  • The Review Status panel’s “Set up” link pointed at a page that no longer exists.
  • Product changelog RSS ignored the per-product switch; the REST feed ignored both switches.
  • Docs changelog dates were a day off on sites with a negative UTC offset.
  • Dashboard: the search success-rate widget never worked, and the pending-reviews and AI-usage widgets never rendered (wrong class names).
  • Settings: featured-docs and footer-social drag-reorder never worked (initialised before SortableJS loaded); the Custom Code “Insert” button did nothing; the Slim SEO detection on the Integrations card used the wrong constant; AI “clear cache” buttons errored while AI was off.
  • Doc Categories page: “Add existing” and “Save order” threw a JavaScript error after saving; “Save order” reported success on failure; deleting a category with only draft docs silently orphaned them.
  • Version Groups: the editor search never showed results; a deleted “latest version” produced warnings and a broken link.
  • Snippets “Used in” never removed a doc after you removed the snippet from it, and didn’t react to deleted docs.
  • Quick Edit on a product or category reset “internal only” to off and cleared draft-version roles.
  • Block editor: bold/italic/code in step titles, FAQ questions and comparison labels showed as literal tags.
  • Markdown import: CRLF files lost their frontmatter; macOS __MACOSX/._* files were imported as docs; a failed ZIP extraction was not reported.
  • Search: an expired nonce on heavily cached pages now triggers a fresh-nonce retry instead of “No results”; excerpts and index content are cut on character boundaries (multibyte text could break the whole result set); highlighting no longer matches inside HTML entities.
  • Elasticsearch product-scoped search returned nothing (filter on a text field); remote storage push failed for non-Latin product slugs (signature and slug handling).
  • Classic editor: edits to the AI summary textarea were never saved.
  • Duplicate SEO tags on doc pages when Built-in SEO Meta was on or Slim SEO / The SEO Framework / SureRank was active.
  • Docs-as-homepage also took over the blog posts page.
  • Single-product mode with more than one product term showed the alphabetically-first product (often an empty one).
  • Subdirectory installs: the docs 404 page never fired and the breadcrumb schema doubled the path.
  • Excluding a category from the sitemap did not exclude its docs; the Yoast archives sitemap was empty.
  • Webhooks: doc.published never fired (always doc.updated); unpublishing a doc never updated the remote index.
  • Plus the two items from earlier in this release: & showing in names, and the category icon hint.
Oct 16
1.0.11
New

1.0.11

A big release: a public roadmap with voting and feature requests, a redesign of almost every admin page, and a rebuilt Content Health check.

New: public roadmap and feature requests

  • The roadmap is off by default. Turn it on under Docs → Settings → Roadmap
  • Public roadmap at /docs/roadmap/ with Under Consideration, Planned, In Progress and Shipped columns, for all products or for one product
  • Visitors can vote on roadmap items, and click again to take a vote back
  • Feature requests board where visitors suggest features. New requests wait for your approval, you get an email for each one, and you can post a public reply from the team
  • Shipped archive grouped by year and quarter, with links to the matching changelog entries
  • Item details open in a popup. On phones, swipe between columns
  • Timeframes such as “Q1 2027”, “H2 2027”, “Mar 2027” or “2027-03” keep Planned and In Progress in date order, under date headings
  • Roadmap block and shortcode to embed the board, the requests or the shipped list on any page
  • Roadmap notes in the sidebar, with different notes per product if you want them
  • Spam protection on requests and votes: a hidden trap, a minimum fill time and a limit of 5 requests per hour per visitor. With Nahnu Login Shield installed, add its CAPTCHA and IP blocking
  • Full right-to-left support, and an Arabic translation of the roadmap

New: roadmap admin

  • Drag-and-drop board under Docs → Roadmap. Drag a card to another column to change its status, or within a column to reorder it
  • Every column except Shipped can be reordered by hand, including Under Consideration, which stays in vote order until you reorder it and has a “Sort by votes” link to go back
  • Card menu with Move to, Move up, Move down, Edit, View and Trash. The menu now always opens in full, in front of the board
  • Feature requests inbox to approve, reply to and bulk-manage requests, with a pending count in the menu
  • The product can be seen and changed on roadmap items even in single-product mode

Redesigned admin pages

  • Settings, now with tabs along the top
  • Snippets, Services, Search analytics, Add-ons, Import Docs, Changelog entries, Content Health and About
  • New Doc Tags page: see the tags each product uses, add existing tags to a product and merge duplicates
  • Search analytics: summary stats, CSV export, and dismissing single searches
  • Add-ons and Integrations now include Nahnu Login Shield
  • About page lists every feature, and the credit now reads Nahnu Plugins

Content Health

  • Health summary, a tile for each check, and sections you can open and close
  • Fixed: “Searches with no results” now works (it read a database column that no longer exists)
  • Checks that can’t run (no WPML or Polylang, feedback off, search analytics off) now say “Not checked” instead of “All clear”
  • Results are kept until the next scan instead of disappearing after an hour
  • Faster link check: links to your own published pages are checked without a web request, each link is checked once per scan, and a scan checks at most 150 distinct links
  • Links ending in #section are now checked, and local sites with self-signed certificates no longer report false errors
  • “Write a doc” button for each search that found nothing

Fixes and improvements

  • Import Docs: fixed errors that could stop an import
  • Settings: saved storage API keys are no longer shown in the page. Leave the field blank to keep a key, or tick Remove to delete it
  • Settings: testing the AI connection now needs an administrator, and settings pages load fewer scripts
  • Notices from other plugins now show below the page header on the docs Dashboard, About, Products and Reader feedback pages, instead of inside it
Oct 7
1.0.10
New

1.0.10

New — Reusable Content Snippets
A new block that lets you define a content fragment once and embed it across multiple docs pages. Useful for shared warnings, prerequisites, version notes, or any text that appears in more than one place — update the snippet and every embed reflects the change.

See: https://www.wpsuperdocs.com/docs/main/writing-docs/reusable-content-snippets/

New — Third-Party Services Registry
A dedicated custom post type for documenting integrations and third-party services. Register each service with its name, description, and status, then display them in your docs using the included block or shortcode. Keeps your integrations index in sync with your actual docs content.

See: https://www.wpsuperdocs.com/docs/main/products-organization/third-party-services-registry/

Fix — Service card showed dark background in light mode
The service card styles were tied to the system prefers-color-scheme media query instead of the plugin’s own theme attribute. Cards would appear with a dark background regardless of the active theme setting.

Fix — Duplicate Products panel in the block editor
WordPress was rendering its own default taxonomy checkbox panel alongside the custom Products selector in the doc and changelog entry editors. The built-in panel is now suppressed so only the custom picker appears.

Fix — Search meta showed & instead of & in product and category names
WordPress stores taxonomy term names with HTML entities in the database. The search index was passing those values directly to JavaScript, which then HTML-escaped them a second time — turning & into &. Term names are now decoded to plain text before being included in the search index JSON.

Fix — og:image used local URL when WP Media Cloud + EWWW Easy IO active
When WP Media Cloud and EWWW Easy IO (ExactDN) are both active, ExactDN disables WP Media Cloud’s URL-rewriting hooks — but it only rewrites <img> tags, not <meta property="og:image">. Social preview images were showing the original upload URL instead of the CDN version. WP Super Docs now reads the CDN URL directly and applies it to both the Open Graph and Twitter Card image tags.

Sep 20
1.0.9
New

1.0.9

OpenAPI Integration (Beta)

Attach an OpenAPI 3.x spec URL to any category and sync. WP Super Docs fetches the spec and creates one draft doc per endpoint using Nahnu Code Block for presentation. Multiple categories across multiple products each sync independently.

Each generated doc contains an Endpoint block, Servers block, Auth block, Parameters block (path, query, header, and request body), Response Body block, Status Codes block, and a cURL example. All data comes directly from the spec.

Re-syncing updates only the generated blocks. Anything written outside that group, before it, after it, or in between, is never touched.

Supported spec formats: OpenAPI 3.x JSON and YAML. YAML support uses the PHP yaml extension if installed, or a bundled pure-PHP parser as a fallback so no server configuration is required.

Requires Nahnu Code Block (v3). Block generation is fully delegated to the new Nahnu_Code_Block_Openapi class, which automatically covers all new block features including auth required badge, example vs default on parameters, typeRef cross-links, show schema toggle, response headers, range and pattern badges, read-only and write-only pills, nullable, endpoint description, related endpoints, operation ID, multiple named examples, and callbacks.

Enabled under Settings → Integrations → OpenAPI. Marked Beta.

See: https://www.wpsuperdocs.com/docs/main/importing-content/openapi-integration/

Doc Categories page

A new dedicated admin page under Docs → Doc Categories replaces the default WordPress taxonomy screen for category management.

Product tabs across the top switch the category list. Each category row shows its name, slug, doc count, and badges for OpenAPI, Internal only, and No sitemap status.

Clicking Edit opens the standard WordPress category edit screen in a new tab with all fields available.

An OpenAPI button appears on each row when OpenAPI is enabled. Clicking it expands an inline panel with the spec URL field, a Save URL button, and a Sync now button so spec management and syncing happen without leaving the page. Sync results appear inline with a link to the first generated doc.

A Save order button is always visible in the toolbar. Categories can be dragged to reorder and the new order is saved on demand. The order is immediately reflected on the frontend — both the sidebar navigation and the category card grid respect it.

A Sync button appears on rows that have an OpenAPI URL set, allowing per-category syncing directly from the list.

Delete is blocked when a category has docs assigned, showing how many need to be moved first.

The default WordPress category taxonomy menu item is hidden.

See: https://www.wpsuperdocs.com/docs/main/products-organization/the-doc-categories-page/

Categories are shared across products

Corrected the data model for category-product associations. Categories are WordPress taxonomy terms shared across the entire site, the same category can appear under multiple products simultaneously. The previous implementation stored a single product ID per category, which incorrectly implied exclusivity.

Associations are now stored as non-unique term meta, allowing one category to belong to any number of product tabs. Adding or removing a category from a product tab only affects that product’s association, leaving all others intact.

An Add existing button appears in the toolbar alongside the renamed New category button. Clicking it loads a dropdown of all categories not yet shown on the current product tab. Selecting one and clicking Add to product creates the association without changing the category’s relationship to any other product. A note in the form explains the shared-category model.

See: https://www.wpsuperdocs.com/docs/main/products-organization/the-doc-categories-page/#creating-a-category

Category order on the frontend

Category order set on the Doc Categories page is now applied to the frontend navigation sidebar and the Browse by category card grid on product pages. The sort runs after all nav tree building regardless of whether a manual nav override is active, making the Doc Categories page the authoritative source for category order across the site.

Search scope dropdown respects product groups

The scope selector shown when searching inside a doc now organises other products by their group labels.

Product switcher modal column count fixed

Ungrouped products were rendering as wpsd-cols-0 because a null group value cast to integer zero. Fixed with a proper fallback so configured column counts are respected.

Sep 16
1.0.8
New

1.0.8

Numbered Steps block. A procedural step list with auto-numbered accent circles. Each step has a title and description. Add, remove, and reorder steps directly in the editor. Renders using WP Super Docs theme variables so the accent color matches your site automatically.

ٍSee: https://www.wpsuperdocs.com/docs/main/writing-docs/numbered-steps-block/

FAQ Accordion block. Expandable question and answer pairs using native HTML details and summary elements, no JavaScript required. Add, remove, and reorder items in the editor. The expand icon uses the accent color and flips to a minus when open.

See: https://www.wpsuperdocs.com/docs/main/writing-docs/faq-accordion-block/

App Store Buttons block. Download buttons for up to seven app stores: Apple App Store, Google Play, Microsoft Store, Amazon Appstore, Samsung Galaxy Store, Huawei AppGallery, and F-Droid. Add a URL to show that store’s button. Leave it empty to hide it. Each icon uses the correct SVG from the store’s own assets, rendered in the current colour so they work in both light and dark mode.

See: https://www.wpsuperdocs.com/docs/main/writing-docs/app-store-buttons-block/

Keyboard Shortcut block. Renders styled keycap keys: Ctrl + C, Cmd + Shift + P, or any key combination. Enter keys comma-separated in the sidebar, pick a separator (+ or →), and optionally add a label before the keys. Keys render as raised keycap badges using the card background and border colors.

See: https://www.wpsuperdocs.com/docs/main/writing-docs/keyboard-shortcut-block/

Requirements block. A prerequisites checklist for tutorials and setup guides. Each item has a label and a type. Required (green checkmark), Recommended (accent star), or Optional (grey circle). Heading is editable. Renders as a bordered card.

See: https://www.wpsuperdocs.com/docs/main/writing-docs/requirements-block/

Comparison block. Two columns side by side for feature comparisons, before and after, or plan differences. Each column has an optional label and a list of items. Each item has a sentiment; Positive (green checkmark), Negative (red X), or Neutral (grey dash). Stacks to a single column on mobile.

See: https://www.wpsuperdocs.com/docs/main/writing-docs/comparison-block/

All blocks follow current WordPress block standards. Each block is registered from its own block.json file with apiVersion 3. Attributes, category, keywords, and asset handles are all declared in block.json. Frontend styles load only on pages that contain the block. All render callbacks use get_block_wrapper_attributes() so Block Supports work correctly.

Add-ons page updated. Nahnu Code Block is now listed alongside Nahnu Video for Bunny Stream.

Sep 13
1.0.7
New

1.0.7

Products page. A new Products page replaces the scattered taxonomy management screen. All product and group management lives in one place. Create products inline with a name, slug, description, and image chosen from the media library. Delete products directly from the page. Drag products to reorder them or move them between groups. Drag the group handle to reorder groups. Click Save layout and everything saves in one request. The WordPress taxonomy menu item, classic editor metabox, and Gutenberg sidebar panel for products are all removed since everything is handled here.

See: https://www.wpsuperdocs.com/docs/main/products-organization/the-products-page/

Product groups. Organize your products into named sections on the /docs/ landing page. Create as many groups as you need, name them anything, and set the display style and column count per group. Ungrouped products always render first. Groups and product assignments are fully managed from the Products page.

See: https://www.wpsuperdocs.com/docs/main/products-organization/product-groups/

Per-group column count. Each group has a columns setting: 2, 3, or 4 per row on desktop. The column count is a maximum, not a fixed count, so a group with 2 products set to 3 columns renders as 2 columns with no empty space. On tablet the layout drops to 2 columns automatically. On mobile it drops to 1.

Compact list style. Groups can be set to Compact list instead of Cards. Compact list uses a grid layout that matches the column count setting, with items showing the product name and an arrow. On tablet it drops to 2 columns, on mobile to 1. The product switcher modal respects the compact style setting per group.

Product switcher modal updated. The modal that lets readers switch between products now shows products organized by their groups, with group labels, and renders each group in its configured style; cards or compact list.

Add-ons page. A new Add-ons item in the plugin menu lists the free companion plugins available on WordPress.org. Currently showing Nahnu Video for Bunny Stream.

See: https://www.wpsuperdocs.com/add-ons/

Sep 7
1.0.6
Improved

1.0.6

Remote Access API. Open your docs to any external tool that needs to search or consume them, support plugins, Slack bots, internal dashboards, AI assistants, or any custom integration. Generate named API keys in Settings → Integrations → Remote Access, each shown once on creation. Three endpoints under /wp-json/wpsd/v1/: live search, index manifest, and per-product index. All require an API key. A support agent tool can search for the right article while reading a ticket. A Slack bot can answer team questions by querying the index. An AI assistant can pull the full doc content to ground its answers. None of them need access to WordPress itself.

See: https://www.wpsuperdocs.com/docs/main/workflow-access-control/remote-access-api/

Index storage: Cloudflare R2 and Bunny.net. Push a split JSON index to Cloudflare R2 or Bunny Edge Storage on every doc save, update, and delete. The index is split two ways: one flat all.json containing every doc across all products, plus one file per product. External tools read through the REST API, storage credentials never leave your server. A progressive push UI shows each file being pushed with a live progress bar and doc count. Last-pushed timestamp shown in the UI.

CDN cache purge. After every push, WP Super Docs automatically purges the updated files from your CDN cache. For Cloudflare R2: requires a Zone ID and an API token with Cache Purge permission. For Bunny: requires your pull zone URL and account-level API key (different from the storage zone key). Both are optional, if not configured the push works without purging.

Webhooks. Register external URLs to receive signed JSON payloads when docs change. Events: doc.published, doc.updated, doc.deleted, and index.resynced. Each webhook has its own signing secret. Payloads are signed with HMAC-SHA256 via the X-WPSD-Signature header so receiving servers can verify authenticity. Send a test ping from the settings without waiting for a real event.

Ask AI: rebuilt retrieval system. The Ask AI widget now uses a two-pass retrieval pipeline instead of a single WordPress keyword search. First, the query is expanded into multiple search concepts, synonyms, related terms, feature names, and alternative wording. For example, “how do I turn on AI?” expands to search for “ai”, “enable ai”, “ask ai”, “ai settings”, “ai search”, and more. All concepts are searched independently and results are pooled and reranked by relevance. The doc named “Enable AI Search” scores overwhelmingly higher than one that mentions AI once in passing.

See: https://www.wpsuperdocs.com/docs/main/ai-features/ask-ai-context-source-custom-instructions-and-provider-selection/

Ask AI: local index. Local mode no longer uses WordPress keyword search. It builds the same in-memory index as the remote mode, all published docs read directly from the database, scored with the same weighted lexical algorithm, and cached for 30 minutes. Title matches score 40 points per word plus a 20-point whole-word bonus plus a 60-point bonus when all query words appear in the title. Body text scores 2. A correctly-titled doc is nearly impossible to miss.

Ask AI: relevant section extraction. Instead of always sending the first 800 characters of each doc, the AI now finds the most relevant section. A sliding window scans the full doc content and picks the chunk with the highest query-word density. Setup instructions buried at character 2000 now get surfaced.

Ask AI: full article awareness. Every doc title is included in the system prompt so the AI knows what exists even when retrieval doesn’t surface the right doc. Previously this only happened in remote mode. Now it applies to local mode too.

Ask AI: context source setting. Settings → AI now has a Context source option: Local reads from the WordPress database, Remote fetches from your configured R2 or Bunny index via its public URL. Remote mode is designed for high-traffic sites that want to reduce database load during AI queries.

Ask AI: provider and model selector always visible. Previously the API key and model selector were hidden when WordPress 7 native AI was detected. Now they always show. If you enter your own Anthropic, OpenAI, or Gemini key, it takes priority over the WordPress native AI, letting you pick a specific model like Claude Haiku.

Ask AI: custom instructions. Settings → AI → Custom instructions lets you tune the AI’s behavior without touching code. A monospaced textarea with a full set of sensible defaults pre-filled, covering search behavior, answer quality, and how to handle missing information. A Reset to default button restores the defaults at any time. Whatever you enter is appended to the system prompt on every request.

All in One SEO support. AIOSEO is now fully integrated. WP Super Docs detects it, defers all title and meta description output to AIOSEO, and reads the processed title and description back via AIOSEO’s API for related-doc snippets, content health scores, and the search index. A card for AIOSEO appears in the SEO plugins section of the Integrations tab.

Sep 3
1.0.5
New

1.0.5

General product. Designate any product as “General” from Settings → General. Enable it with a toggle, select the product from the dropdown, and its docs appear first on the /docs/ landing page and automatically in the sidebar of every other product. The icon, image, and description are set through the normal product screen. Turn the feature off at any time without losing your settings.

See: https://www.wpsuperdocs.com/docs/main/products-organization/the-general-product/

Docs homepage: global links. Pin up to 5 docs in Settings → General. They appear as the first group in the sidebar on the /docs/ landing page, labelled “Quick links”, so readers can get to cross-product content like account settings or billing without picking a product first.

See: https://www.wpsuperdocs.com/docs/main/products-organization/the-docs-homepage-sidebar-quick-links-product-groups/

Multi-product sidebar. On the /docs/ landing page when multiple products are present, the sidebar shows each product as a collapsible group with its pinned or popular docs as items. The global quick links appear first, then each product group below. Products with no pinned docs are omitted. Single product mode is unchanged.

Per-product homepage links. On the Navigation page, each product has a “Docs homepage links” section above the nav builder. Pin up to 5 docs that populate that product’s sidebar group on the landing page. If Post Views Counter or WP Statistics is active, a toggle lets you auto-populate from the top 5 most-viewed docs for that product instead.

RTL support. All new landing page and mobile nav elements support right-to-left layouts.

Sep 3
1.0.4
Improved

1.0.4

Callout blocks: custom colours and icons. The [wpsd - callout] (spaces add so shortcode is text) shortcode now accepts a color attribute with any hex value to set a fully custom border, background tint, and title colour. It also accepts an icon attribute with any media library URL so you can use your own SVGs or images as the callout icon. Lists and nested content work inside all callout types.

See: https://www.wpsuperdocs.com/docs/main/writing-docs/callouts-wpsd-callout/

Appearance tab: theming resources. The Appearance settings tab now includes links to the CSS variables reference and a guide on using AI to theme your docs, so you know the color pickers are just the starting point.

See: https://www.wpsuperdocs.com/theming/ & https://www.wpsuperdocs.com/docs/main/navigation-appearance/theming-with-css-variables/

Sep 2
1.0.3
Fixed

1.0.3

Light/dark logo gap fixed: When only a light logo was showing, a gap appeared between it and the site name because the dark logo — though invisible — was still rendered as a flex item. The CSS cascade was overriding the hide rule with a later, equal-specificity rule. Fixed by reordering the declarations so the show/hide rules always win.

Sep 2
1.0.2
Fixed

1.0.2

Search excerpt fix: HTML entities such as ', &, and → now display correctly in search result snippets instead of appearing as raw escape codes.

Sep 2
1.0.1
New

1.0.1

Mobile nav footer: Added a “Back to site” link at the bottom of the mobile drawer navigation. It uses the back-to-site URL configured in Settings and only appears when a URL is set.

Sep 1
1.0.0
Announcement

1.0.0 (Initial Release)

Multi-product docs system: Organise documentation across unlimited products, each with its own navigation, categories, and versioning.

Standalone layout: Full docs site rendered independently of your WordPress theme. Dark mode included.

Drag-and-drop nav builder: Build per-product navigation manually or let it generate automatically from categories.

Version groups: Maintain multiple versions of your docs with one-click reader switching.

Admin dashboard: Customisable widget dashboard covering stale docs, content health, recently updated, search analytics, reader feedback, and more.

AI writing tools: Generate summaries and suggestions using OpenAI, Anthropic, or Gemini. Token usage tracked per model.

Embeddable changelog widget: A floating “What’s new” widget for any app or site. Configurable dismiss duration, position, and accent colour.

Product changelog: Structured changelogs per product with entry types (feature, fix, improvement) and version tags.

Search integrations: Auto-detects SearchWP, Relevanssi, and Ivory Search. Falls back to native WordPress search.

Search analytics: Track top searches, failed searches, and search success rate from the admin.

Reader feedback: Thumbs up/down on every doc. Aggregate feedback visible in the dashboard.

Review workflow: Assign docs for review with email notifications on status changes.

Content health: Flag stale, stub, and uncategorised docs. Track word count and publishing velocity.

Import tools: Import from Markdown ZIP, Intercom, Help Scout, BetterDocs, and weDocs.

Search index export API: A REST endpoint serving all docs as JSON, ready for Algolia, Meilisearch, or Typesense.

Algolia and Elasticsearch: Push docs into Algolia or Elasticsearch with automatic indexing on publish and removal on delete.

SEO: Compatible with Yoast SEO, Rank Math, SEOPress, and Slim SEO.

Multilingual: WPML and Polylang compatible with correct URLs in both plugins.

Footer builder: Per-product footer with logo, social links, and custom columns. Global default with per-product overrides.

Custom code: Inject custom CSS/JS into the docs layout without editing files.

Preview links: Share private previews of draft docs without publishing.

Internal-only docs: Restrict specific docs to logged-in users.

SureCart licensing: Built-in license activation and automatic plugin updates via SureCart.

This website uses cookies to enhance your browsing experience and ensure the site functions properly. By continuing to use this site, you acknowledge and accept our use of cookies.

Accept All Accept Required Only