From 331a24e752facf26af56e0571e209f2347d148c9 Mon Sep 17 00:00:00 2001 From: w0kyj Date: Fri, 26 Dec 2025 10:16:05 -0700 Subject: [PATCH] docs: add organization sections for Flows and Collections MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add documentation for folder/grouping features: - Flows: New "Organizing Flows" section covering folders, nesting, drag-drop sorting, and search capabilities - Collections: New "Organizing Collections" section with same structure Related to directus/directus#26431 🤖 Generated with [Claude Code](https://claude.ai/claude-code) Co-Authored-By: Claude Opus 4.5 --- content/guides/01.data-model/1.collections.md | 29 ++++++++++++++++++ content/guides/06.automate/1.flows.md | 30 +++++++++++++++++++ 2 files changed, 59 insertions(+) diff --git a/content/guides/01.data-model/1.collections.md b/content/guides/01.data-model/1.collections.md index 893e4a9b..e0388793 100644 --- a/content/guides/01.data-model/1.collections.md +++ b/content/guides/01.data-model/1.collections.md @@ -46,6 +46,35 @@ Additionally, Directus can create some common fields, including a status field, Explore the Collections API to create and manage collections. :: +## Organizing Collections + +As your data model grows, you may have many collections serving different purposes. Directus provides several ways to keep your collections organized. + +### Folders and Nesting + +Create folders to group related collections together, or nest collections directly under other collections to create logical hierarchies. + +**Folders** are organizational containers that don't store data. To create a folder: +1. Navigate to **Settings > Data Model**. +2. Click the **Create Folder** button in the header. +3. Enter a name, choose an icon and color, and optionally select a parent. + +**Collection nesting** allows you to group related collections together. For example, nest `post_comments` and `post_tags` under a parent `posts` collection to show their relationship. + +To move a collection into a folder or under another collection: +- **Drag and drop** the collection onto the target in the list. +- Or configure the collection and select a parent from the **Folder** dropdown. + +Both folders and collections can be nested to create deep hierarchies. They can be expanded or collapsed using the toggle icon, and their state is preserved across sessions. + +### Drag and Drop Sorting + +Collections and folders can be reordered by dragging the handle on the left side of each row. The sort order is saved automatically. + +### Search + +Use the search bar to filter collections by name, note, or field names. Parent folders and collections remain visible when they contain matching children, preserving the hierarchy context. + ## Configuring Collections Once a collection is created, there are a number of configuration options available. diff --git a/content/guides/06.automate/1.flows.md b/content/guides/06.automate/1.flows.md index 36c9a086..d0ea3acf 100644 --- a/content/guides/06.automate/1.flows.md +++ b/content/guides/06.automate/1.flows.md @@ -13,6 +13,36 @@ Flows enable custom, event-driven data processing and task automation within Dir - **Description** — Sets a brief verbal description of the flow. - **Color** — Sets a color to help identify the flow. - **Activity and Logs Tracking** — Selects whether the flow should be tracked in both the [activity log](/guides/auth/accountability) and the flow's logs, only in the activity log, or neither. +- **Folder** — Optionally assign the flow to a folder for organization. + +## Organizing Flows + +As your project grows, you may have many flows serving different purposes. Directus provides several ways to keep your flows organized. + +### Folders and Nesting + +Create folders to group related flows together, or nest flows directly under other flows to organize related automations. + +**Folders** are pure organizational containers (they don't execute). To create a folder: +1. Navigate to **Settings > Flows**. +2. Click the **Create Folder** button in the header. +3. Enter a name, choose an icon and color, and optionally select a parent. + +**Flow nesting** allows you to group a main flow with its related utility flows. For example, nest helper flows under the primary flow they support. + +To move a flow into a folder or under another flow: +- **Drag and drop** the flow onto the target in the list. +- Or edit the flow and select a parent from the **Folder** dropdown. + +Both folders and flows can be nested to create deep hierarchies. They can be expanded or collapsed using the toggle icon, and their state is preserved across sessions. + +### Drag and Drop Sorting + +Flows and folders can be reordered by dragging the handle on the left side of each row. The sort order is saved automatically. + +### Search + +Use the search bar to filter flows by name, status, description, or trigger type. Parent folders and flows remain visible when they contain matching children, preserving the hierarchy context. ## Logs