August
This month strengthens security around project creation, introduces a redesigned dashboard sidebar, gives workspace admins more control over documentation review, and makes API references more accurate for OpenAPI and GraphQL specs. It also resolves a wide range of editor, import, publishing, and search issues across the platform. Here's everything that's new.
Redesigned Sidebar
A cleaner dashboard navigation with workspace switching, quick links, and a collapsible layout.
Richer Content Tools
Glossary support, header sections at every level, and llms-full.txt generation.
More Accurate API References
Conditional field requirements, named response examples, and valid GraphQL sample queries.
Review & Publishing Control
Admins can publish without waiting on review approvals, and reviewers' notes now reach requesters.
New Features & Enhancements
Redesigned Dashboard Sidebar
The dashboard sidebar has been rebuilt to make navigation and workspace management faster. The main navigation is now organized as Dashboard, Projects, Analytics, and Brand Expressions, which brings Branding and Developer Portal together in one place.
- User menu: Open your profile settings, invite teammates (with a workspace selector in the invite modal), and switch your default workspace from a single dropdown.
- Quick links: Open the Theneo User Guide and the API Editor in a new tab directly from the sidebar.
- Help menu: Contact support, ask AI for help, or report a problem from the help icon.
- Theme switcher: Toggle between light and dark mode; your preference is saved across the app.
- Collapsible layout: Collapse the sidebar to icons only, with labels shown on hover.
Glossary Support
Build a glossary directly into your documentation, giving readers a single place to look up key terms without leaving the page.
Header Sections at All Levels
Header (non-clickable, organizational) sections can now be added at every level of your documentation structure, not just the top, for more flexible organization of longer projects.
llms-full.txt Support
Theneo now generates an llms-full.txt alongside the existing llms.txt, giving AI assistants and agents a complete, structured view of your documentation for more accurate answers.
Conditional Field Requirements for OpenAPI
Theneo now understands OpenAPI schemas where a field's requirement depends on other fields. Fields defined with if/then constraints are labeled with their condition (for example, "Required if quantity is provided"), and fields defined with oneOf + required show a mutual-exclusivity note (for example, "One of status or statusId is required").
ExampleRequest:
type: object
properties:
status:
type: string
statusId:
type: integer
oneOf:
- required: [status]
- required: [statusId]
Flexible Placement for Status Codes and Error Codes
The Status Codes and Error Codes widgets are no longer locked to the right-hand column. Each widget can now be displayed inline with your main content, which works well for sections that have little or no right-column content.
1
Open the widget menu
Click the three-dot menu in the widget header and select Edit display.
2
Choose the placement
Turn off Display on the right side of the content to show the widget in the main content column of your published docs.
3
Save and publish
The setting is saved per widget and per section, so Status Codes and Error Codes can be placed independently.
Existing sections are unaffected. Both widgets stay on the right side unless you change the setting. The widget header's Edit and Delete actions are now combined into a single three-dot menu.
Admins Can Publish Regardless of Review Status
Workspace admins can now publish documentation at any time, even when a documentation review is pending or required approvals haven't been collected yet. This makes it possible to ship urgent fixes and time-sensitive updates without waiting on the review cycle.
This override applies to workspace admins only. All other roles continue to follow the existing documentation review workflow.
Import HTML, CSS & JS into the Developer Portal Editor
A new Import button in the Developer Portal editor toolbar lets you upload local files instead of pasting code by hand. HTML (.html, .htm) loads into the page canvas, CSS (.css) into the styles, and JavaScript (.js) into the JS editor. You can upload one or more file types at once.
Imported files replace the current content of the matching editor, and you'll be asked to confirm before changes are applied. Each file can be up to 1 MB. Imported changes are staged only, so click Save & Publish to make them live.
Automatic Branding on Sign-Up
When you sign up with a company email address, Theneo now automatically pulls in your company's logo, brand colors, and favicon, and activates a one-week trial so you can start building branded documentation right away.
Automatic SEO Generation for New Projects
SEO metadata is now generated automatically for every page when a project is created. You no longer need to open SEO management and save each section manually to populate it.
Editor & Publishing Fixes
- API Version Switching in the Editor: Fixed an issue where the editor's version dropdown did not switch between API versions in projects with multiple versions configured.
- Mermaid Diagram Widget UI Fixes: Resolved several UI issues in the Mermaid diagram widget, including unreadable labels in the editor preview and long text overflowing diagram nodes.
- Strikethrough Now Renders in Published View: Fixed a bug where strikethrough formatting applied in the editor wasn't showing up once a document was published.
- Codeblock Syntax Highlighting Fixed When Comments Are Present: Resolved an issue where adding comments inside a code block would break syntax highlighting for the rest of the block.
- Fixed Accidental Auto-Linking on Periods: Fixed a bug where formatting a word ending in a period and pressing Enter would incorrectly convert the entire sentence into a link.
- Fixed Typing Next to Inline Code: Resolved an issue that prevented users from typing directly next to inline code-formatted text on the same line.
Published Docs & Search Fixes
- Correct Favicon on Custom Domains: The
/favicon.icopath on custom domains now serves your configured favicon instead of Theneo's default, so search engines display your branding. - API Explorer and Changelog Links Update After Slug Changes: On custom domains, the API Explorer and Changelog links in the custom menu now follow project slug changes instead of pointing to the old slug.
API Documentation Fixes
- Valid GraphQL Sample Queries: Generated GraphQL sample queries, used in Try It and the GraphQL code tab, now keep exact type-name casing for scalars, custom scalars, and enums, preserve list and non-null modifiers, and no longer add selection sets to scalar list fields.
- OpenAPI Contact, License, and Terms of Service Imported:
info.contact,info.license, andinfo.termsOfServicefrom your OpenAPI spec are now parsed on import. - Curl Code Samples Now Use
--userfor Basic Auth: Fixed an issue where generated curl code samples used anAuthorization: Basicheader instead of the--userflag for HTTP basic auth, ensuring generated samples follow curl's standard convention. - SOAP Namespace Prefix Preserved in Published Examples: Fixed a bug where the
soap:namespace prefix was being stripped from XML request/response examples after publishing.
Workspace & Analytics Fixes
- Access Management Visibility Changes Save Correctly: Fixed an issue in Advanced Access Management where changing a section from Public to Private could fail silently and remain Public.
- Analytics Tooltips Fully Visible: Tooltips on the Analytics page no longer render behind the sidebar.
On this page
- August