6.1 - 15 October 2026
Upgrade notes
- You MUST upgrade to WebHare 5.9.1 or higher and upgrade to Postgres 17 or higher before upgrading to WebHare 6.0 or 6.1.
- But you should upgrade to at least WebHare 5.9.6 and deal with any reported deprecation warnings. Run
wh deprecationscanmanually for a direct report after updating (the built-in report in the dashboard is generated only once a week).
- But you should upgrade to at least WebHare 5.9.6 and deal with any reported deprecation warnings. Run
- WebHare 6.2 will remove support for DrawLib/wh::graphics bitmapped text-rendering APIs. We recommend using SVGs or Puppeteer's screenshot API for text image generation.
- We've moved to https://github.com/WebHare/platform/ as our primary source code hosting location. Please submit new issues and pull requests there, or use https://github.com/WebHare/platform/discussions for community discussions, Q&A, etc.
- We've renamed the primary branch from 'master' to 'main'.
Things that are nice to know
- Publisher
- The version history dialog can query server-wide version history. Editors can inspect metadata and view earlier workflow versions.
- Editor screens now include an Inspect Metadata action.
- Forms and Tollium
- Frontend forms can update form variables and hidden fields dynamically; rich-value form components also support dynamic updates.
- A form filter hook is available for custom spam filtering.
- Websites and webdesigns
fsObjectPolicycan suggest publication start and end dates and provide a live-preview placeholder for the Meta Title field.- TypeScript webdesign widgets can access the current web request and content instance, and append structured data to the page.
- Content links are transparent to apply rules, which now use the final file type when determining applicable rules.
- Mark whfsTypes whose properties can be set for content link files with
contentLink: truein their siteprofile definition.getInstanceDataon WebDesign/pageRequest objects will honor this flag. - Set
ogimageresourceorpageMetaData.imageResourceto have WebHare determine the format, scaling, and absolute URLs for OpenGraph metadata.
- Authentication
- OpenID Connect login supports PKCE, returns the user's email in userinfo, and avoids prompting for scopes already granted.
- WRD
- The
delete()API now limits deletion to entities of the type on which it was called, preventing accidental mixing of IDs. - The HareScript API now supports UUIDs in
Search/RunQueryqueries forWRD_GUIDfields, eliminating the need to useUUIdToWRDGuid.
- The
- Developer tooling
- The WebHare language server now lets you follow resource paths in XML/YML files and jump to their definitions with F12 in VS Code.
TypeScript/JavaScript highlights
- Generic
createWebResponseacceptslittytemplate literals.
- Frontend
waitForElementacceptsElementand SVG elements, and supports more selector types.
- Backend
- The WHFS API adds
LookupURLfor resolving WHFS URLs. getInstanceSourceidentifies the object ID to use when querying a filesystem type.- TypeScript webdesign routers can invoke HareScript routers and support dynamic page parameters and router subcalls.
- Image-cache conversions now run in the JavaScript service, including AVIF conversion paths.
- The WHFS API adds
- Testing and debugging
test.transitionsToTruechecks whether a condition became true because of the action being tested, andtest.scopedPrefixprefixes failure annotations.wh harescript-debug locks <pid>lists locks held by a process.
Incompatibilities and deprecations
- Image resize methods
stretch,stretch-x,stretch-y,cropandcropcanvasare no longer supported. - Configurable output extensions are no longer supported.
- The
wh sslcommand is nowwh crypto. Subcommands are hyphenated; use the global--jsonoption instead of--format json. - The deprecated
CreateImageEditDialogandTolliumImageEditcomponents have been removed. - Deprecated authentication exports have been removed from their former package; use
@webhare/auth. - WebHare 6.1 ignores
towl<notification>elements inmoduledefinition.xmlfiles; usemoduledefinition.ymlinstead. onsetenabledin richdocument has been removed. Useeditdocumentapi->AddEventListener("readonly", ...)instead. ConsiderGetWebhareVersionNumber()if you need to support both 6.1 and earlier versions.
To get the full list of changes between 6.0 and 6.1, run: git log $(git merge-base main origin/release/6.0)..$(git merge-base main origin/release/6.1).