Structr 6.2.0
Structr 6.2.0 is a feature release with a major highlight: the new integrated documentation system is now shipped directly with Structr, providing comprehensive, searchable documentation right inside the UI. This release also introduces DoS protection for production hardening, improved global search with result highlighting, a comprehensive OAuth refactoring, and numerous bugfixes.
New Integrated Documentation System
The most significant addition in Structr 6.2.0 is the completely new built-in documentation system, fully integrated into the Structr UI. This replaces the previous external documentation with a comprehensive, always-available reference that ships directly with the platform and evolves together with it.
The new documentation features a dramatically improved structure and navigation, full-text search across all articles, Markdown-formatted function detail sections with code snippets, and extensive coverage of system types, services, built-in traits, and all built-in functions. New and heavily revised articles cover topics like URL Routing, Prefetching, RSS Feeds, Event Action Mapping, the Data Model, and Getting Started, among many others.
New Features
DoS Filter / Rate Limiting
- Built-in rate limiting through Jetty’s DoSFilter with all init parameters exposed as configuration settings
- Default localhost whitelist (“127.0.0.1”) for development environments to avoid throttling during local development
Global Search Improvements
- Display of matched values with highlighting in search results
- More generic search interface and implementation
- Moved global search code into the database layer with proper tenant identifier support
- Improved overflow handling for long search results
Prefetch2 Scripting Access
- Exposed
prefetch2to scripting for programmatic data loading optimization
Content Type Autodetection
- Automatic detection of content type when changing Content or Template node content from initial text
Wildcard Host Classes
- Wildcard support for the
allowedHostClasssetting
SSH for Non-Admin Users
- SSH connections now allowed for non-admin users (Admin Console access remains restricted to admins)
OAuth Refactoring
- Comprehensive refactoring of OAuth implementation with new tests and updated documentation
Enhancements
User Interface
- Updated popup notification styles with better padding, button wrapping for smaller screens, and restored button colors
- “Importer” section renamed to “Job Queue” for clarity
- Smarter UI defaults: Content defaults to Editor, DOM Node to HTML, Page to General when no tab was manually selected
- Deployment target/source paths visible on hover via element titles
- Fixed code area visual bugs when showing recent types or moving resizers
- Limited max length of “updated property x to value y” messages to prevent overflow
- Updated styles to prevent font sizing issues in Monaco code editor suggestions
Schema and Data
- Duplicate relationship warnings shown by default
- Optional warning for non-unique schema relationship type names
- Correct
_schemaresource info generation for system enum attributes fromExcelfunction pre-populates rows with all header keys to ensure they are always present- Visibility flags always fetched when listing nodes in the data area to ensure proper lock icon functionality
Configuration
- Registration and reset-password mails now use
smtp.userif it is a valid address, falling back to the default string only when necessary - Configured upload folder used by default for superuser uploads
- More detailed configuration for resource access permission notifications
- Prevent creation of duplicate settings via config UI
Other
- Removed default ‘all’ for
detailsparameter - must be set explicitly for selective use - Allow filters for path-based topic resolution
- Removed deprecated
globalSchemaMethodsbinding - Java access to Cypher properties
- Corrected selectable parameter types for custom URL Routing to reflect backend support
Bugfixes
Core
- Fixed cleanup of previous flows when importing applications without existing flows
- Fixed
ZipArchiveFunctionnot cleaning up after itself - Fixed handling of reserved path characters in
StructrSSHFilesystem - Prevented exception when returning non-String values
- Fixed console REST commands by removing
optionalparameter from RestAssured - Silently ignore invalid date in
If-Modified-Sinceheader as per RFC 7232
Graph Browser and DOM
- Fixed node click handling and edit relationship dialog in graph browser
- Prevented replacing nodes with Templates and vice versa
- Prevented
onUploadhandlers from running when creating files in admin UI (only on actual upload)
Files and Folders
- Files remain accessible after renaming a folder
- Correct name shown in popup dialog when deleting a renamed folder
- File icon path updated when renaming a file
- Use configured upload folder by default for uploads with superuser
Deployment
- Correctly import deployment exports with only user-defined functions or only function properties
- Proper sorting and validation in metadata-only folder import
- Relationship types removed from data deployment export dropdown (export is node-centric)
- Graceful handling of unknown schema types in data deployment export and import
- Correct target type when loading existing CSV importer mapping config
Other Fixes
- Schema node cache cleared correctly before reloading
- Fixed
SchemaRelationshipNodebug - Removed duplicate path elements and duplicate trait registration
- Correct tenant identifier handling in global search
- Correctly append detail elements to function documentation
Quality of Life
- Improved output of
$.log(exception)and reduced console noise - Better Java exception logging in
doInNewTransactionerror handler - Removed unused
returnTypeandsignatureattributes from schema methods - Updated support forum link
Infrastructure
- GitLab Migration: CI/CD pipeline migrated from GitHub to GitLab with Docker registry, package registry for releases, and automatic enterprise pipeline triggering
- Automatic copying of UI screenshots to docs after test runs
- UI tests made independent of each other with improved macOS compatibility
- Updated
publiccode.yml, README, license files, and year to 2026
Upgrade Notes
- Recommended for all Structr 6.1.x users
- The “Importer” has been renamed to “Job Queue” in the UI
- OAuth has been refactored - review your OAuth configuration after upgrading
- SSH access is now available for non-admin users (Admin Console access remains admin-only)
- See the migration guide for general Structr 6.x upgrade information