5.8 - 26 August 2025

PLEASE NOTE! YOU NEED TO UPGRADE TO 4.35 BEFORE UPGRADING TO 5.xx

Incompatibilities and deprecations

• we no longer use unique cookienames on rescue ports. use alternative IPs (eg 127.0.0.2) or other browsers if you need to log into multiple localhost webhares at the same time
• drop support for 'wh applyfile <wdschema>.xml' (incomplete as it doesn't do the TS parts anyway)
• GenerateBrowserScreenshot has been reduced to taking width/height and alpha setting. use @webhare/deps' puppeteer if you need more features
• Support for sitetag= and wrd_authdomain fields has been removed. Use <wrdauth lastloginfield= to set the field for last-login dates
• support for wrdauthsupport object useredit policies has been dropped
• whuserDisabled (and whuserDisableType) in system:usermgmt have been replaced with wrdauthAccountStatus. scripts manually creating/manipulating users may need to be updated
• WRD fields of type 'PASSWORD' can no longer be created. Existing fields will be upgraded to AUTHENTICATIONSETTINGS - this may break direct reading of password fields (which you shouldn't do anyway)
• You can no longer filter by password hash in WRD queries
• GeneratePDFFromFile seems unused now and has been removed

Things that are nice to know

• Modules are now installed using background tasks to prevent cancellation due to timeout/connection loss of the pusher
• Add BuildRTDFromYAML to HareScript for fast RTD creation
• Publisher multipage forms now interpret "Enter" as "go to next page" and not "submit". this avoids triggering an error on all fields
• User management roles can have email addresses
• Offers faster rpc.json compilation by adding ?proxy to the URL. incompatible with the import * as syntax!
• webdesignplugins can specify a separate parser= for use by the siteprofile compiler. use this to reduce the number of module-loadlibs (and thus recompilations) needed during bootstrap
• <accountstatus> field to manage wrdauth_account_status
• allows you to configure additional headers (eg AWS headers) for outgoing mail
• expose HareScript Get/SetWRDSetting(s) APIs
• expose TS getSchemaSettings/updateSchemaSettings APIs
• password policy configuration has been moved from dashboard to the WRD App's login settings so it can be made available to all WRD schemas. this screen can also be opened by clicking the root's unit properties in user & rights management
• roles can have email addresses
• use <migration at=create/update> to skip the migration script unless the schema is being created or updated
• userproperties can now be hooked through backendHooks for platform:userproperties in moduledefinition.yml
• you can now disable password logins for a unit to ensure login using a 3rd party provider

TypeScript/JavaScript highlights

• WRD image/file fields no longer accept { data: Buffer }, use ResourceDescriptors

To get the full list of changes between 5.7 and 5.8 yourself, use: git log $(git merge-base master origin/release/5.7)..$(git merge-base master origin/release/5.8)