Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 8 additions & 6 deletions docs/content/navigation/PRO__global_search.md
Original file line number Diff line number Diff line change
@@ -1,18 +1,20 @@
---
title: "Global Search"
description: "Search across Findings, Assets, and related objects from the DefectDojo Pro topbar"
description: "Search across Findings, Assets, related objects, and every menu destination from one dialog in DefectDojo Pro"
audience: pro
weight: 3
---

DefectDojo Pro includes a **global search** that looks across your Findings and related objects from a single box in the topbar. It is backed by native Postgres full-text search with fuzzy, typo-tolerant matching, so you can find an object without remembering its exact wording.
DefectDojo Pro includes a **global search** that looks across your Findings and related objects. It is backed by native Postgres full-text search with fuzzy, typo-tolerant matching, so you can find an object without remembering its exact wording.

Global search finds your **data**: findings, assets, engagements, and the other records listed below. To find a **page** (a menu destination such as a settings screen or a list view), use the menu search instead: press **Cmd+K** or **Ctrl+K**, or the magnifying-glass control in the top-right corner of the sidebar. See [The Sidebar Menu](/navigation/pro__sidebar/).
As of DefectDojo Pro 3.3.100, data search and menu search share one dialog. **Data Results** are your records: findings, assets, engagements, and the other types listed below. **Navigation Results** are pages: every menu destination your account can reach, searchable by label, position and related vocabulary. See [The Sidebar Menu](/navigation/pro__sidebar/) for how navigation results rank and what they cover.

![The Global Search dialog with data and navigation results](images/global_search_dialog.png)

## Running a search

- **Topbar search box** — click the **Search** box in the top navigation and start typing. As you type, a dropdown previews the top matches **grouped by object type**, with a count next to each type and a **See all *N* results** link at the bottom.
- **Full results page** — press **Enter**, or click **See all *N* results**, to open the full results page. This is a single, sortable, filterable table of every match across all object types.
- **Open the dialog**: select the **Search** field at the top of the sidebar, press **Cmd+K** (Mac) or **Ctrl+K**, or (with the sidebar collapsed) the magnifying glass under the logo. Start typing: the top data matches appear first, each chipped with its object type, with the menu destinations that match beneath them.
- **Full results page**: select **See all *N* results** under the data results to open the full results page. This is a single, sortable, filterable table of every match across all object types.

Results are always **scoped to what you are authorized to view** — global search never surfaces objects you would not otherwise have access to. (Finding Templates are the one exception: like elsewhere in DefectDojo, they are visible to any signed-in user.)

Expand Down Expand Up @@ -72,4 +74,4 @@ On the full results page, the columns can be filtered and sorted independently o

- The full results page is **paginated** (25 rows per page by default).
- Each object type contributes up to a **maximum number of matches** per search — **100** by default. When more matches exist than are shown, the results are flagged as truncated; narrow your query to see the most relevant hits.
- The topbar dropdown shows a smaller preview (the top few matches per type) with the total counts, so **See all *N* results** always reflects the true totals.
- The dialog shows a smaller preview (the top few matches) with the total count, so **See all *N* results** always reflects the true totals.
7 changes: 5 additions & 2 deletions docs/content/navigation/PRO__menu_badges.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Menu Badges"
description: "What the SOON, NEW, BETA, LEGACY and DEPRECATED tags in the DefectDojo Pro sidebar mean, and what each one asks you to do"
description: "What the SOON, NEW, BETA, LOCKED, LEGACY and DEPRECATED tags in the DefectDojo Pro sidebar mean, and what each one asks you to do"
weight: 7
audience: pro
---
Expand All @@ -11,10 +11,13 @@ Entries in the DefectDojo Pro sidebar can carry a small coloured tag. Each one a
| --- | --- | --- | --- |
| `SOON` | Gold | Announced, not released yet | Nothing. The entry does not open a page |
| `NEW` | Green | Recently released | Nothing — it is there so you notice the feature |
| `BETA` | Orange | Working, still being finished; behaviour may change between releases | Try it, and expect rough edges |
| `BETA` | Brand-colored | Working, still being finished; behaviour may change between releases | Try it, and expect rough edges |
| `LOCKED` | Grey | Not included in your license | Selecting the entry explains what unlocks it |
| `LEGACY` | Red | Superseded by a newer feature, with no announced removal date | Prefer the replacement for new work |
| `DEPRECATED` | Red | Scheduled for removal in a named release | Migrate before that release |

Two badges carry a small icon on their corner so they stay recognizable at a glance: `NEW` a flame, `BETA` a seedling. `LOCKED` carries a padlock inside the pill. When the sidebar is [collapsed to its icon rail](/navigation/pro__sidebar/#collapsing-the-sidebar), those icons are what remains: they shrink to small marks on the row's icon, in the badge's colour, and hovering the row names the page and its badge together.

## SOON marks a capability that has not shipped

A `SOON` entry is the only one that does not open a page. It is greyed out, and selecting it explains that the capability is on the way rather than navigating anywhere.
Expand Down
31 changes: 26 additions & 5 deletions docs/content/navigation/PRO__sidebar.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,15 @@
---
title: "The Sidebar Menu"
description: "How the DefectDojo Pro sidebar is organized, how to search it, the All Settings directory page, and how to switch between the current and previous layouts"
description: "How the DefectDojo Pro sidebar is organized, how to search it, collapsing it to an icon rail, the All Settings directory page, and how to switch between the current and previous layouts"
weight: 6
audience: pro
aliases:
- /navigation/pro__settings_menu/
---

The DefectDojo Pro sidebar groups every page in the product into five sections, ordered by how the product is used rather than by how its data is structured. The views you open to find work come first; the record catalogs you drill into sit behind them. This layout is the default on every instance from DefectDojo Pro 3.2.200 onwards. An administrator can switch back to the previous layout at any time (see [Switching layouts](#switching-layouts)).
The DefectDojo Pro sidebar is the application shell: as of DefectDojo Pro 3.3.100 it runs the full height of the window and carries the brand, the search field, the menu, and (at the bottom) your account, alerts and the light/dark switch. There is no separate top bar on desktop; on phones and small windows the sidebar becomes a drawer behind a top-bar menu button.

The menu groups every page in the product into five sections, ordered by how the product is used rather than by how its data is structured. The views you open to find work come first; the record catalogs you drill into sit behind them. This layout is the default on every instance from DefectDojo Pro 3.2.200 onwards. An administrator can switch back to the previous layout at any time (see [Switching layouts](#switching-layouts)).

Either way, **every page keeps the same URL**. Bookmarks, saved links and anything in your own runbooks continue to work regardless of which layout is active.

Expand All @@ -23,11 +25,14 @@ Either way, **every page keeps the same URL**. Bookmarks, saved links and anythi

You only ever see the entries your account has permission to open, and a group disappears entirely when none of its pages are available to you.

## Searching the menu
## Searching

The **Search** field at the top of the sidebar, and **Cmd+K** (Mac) or **Ctrl+K** anywhere, open one **Global Search** dialog with two kinds of results:

Press **Cmd+K** (Mac) or **Ctrl+K**, or select the small magnifying-glass control pinned in the top-right corner of the sidebar, to open **Search Navigation Options**: a search over every menu destination your account can currently reach. The control shows the shortcut for your platform, so it reads `Ctrl K` on Windows and Linux, and the whole control is clickable. It stays in the corner as the menu scrolls.
- **Data Results**: your records (findings, assets, engagements and the rest), through the same engine as the full results page. **See all results** at the bottom opens that page. See [Global Search](/navigation/pro__global_search/).
- **Navigation Results**: every menu destination your account can currently reach.

Results match more than the entry's label. Each destination is also searchable by its position in the menu and by related vocabulary, so `finding` surfaces **Findings > All** even though the entry itself is labelled "All", and `sso` surfaces the authorization providers. Each result shows where the entry lives in the menu and a one line description of the page.
Navigation results match more than the entry's label. Each destination is also searchable by its position in the menu and by related vocabulary, so `finding` surfaces **Findings > All** even though the entry itself is labelled "All", and `sso` surfaces the authorization providers. Each result shows where the entry lives in the menu and a one line description of the page.

Move through results with the arrow keys, open one with **Enter**, and close the search with **Escape**. Entries that open in the Classic UI are marked and open in a new tab. The search only ever lists pages you could also reach through the sidebar: permissions, feature flags, and license entitlements apply to it identically, and it follows whichever menu layout is active.

Expand All @@ -38,6 +43,22 @@ Three conventions run through the whole menu:
- **A feature occupies one entry, not one per screen.** PSIRT's nine pages, the Triage Engine's four and the record catalogs all sit behind a single entry each, instead of spreading across the menu.
- **An entry is not repeated inside itself.** Where a group already names the thing, its entries do not name it again: **Findings** holds Active, Mitigated and All rather than "All Findings", and **Attack Surface** holds Endpoints and Hosts rather than "All Endpoints".

## Collapsing the sidebar

The chevron beside the logo, or **Cmd+B** (Mac) / **Ctrl+B**, collapses the sidebar to a slim icon rail and back. Your choice is remembered across reloads. On desktop windows narrower than 1200px the rail starts collapsed to leave room for content; widening the window brings your stored preference back. (Cmd+B is ignored while you are typing in an editor, where it means bold.)

![The collapsed rail with a section flyout open](images/sidebar_rail_flyout.png)

While collapsed:

- Rows show only their icon. Hovering a page shows its name (and its badge, if it carries one) as a tooltip.
- Hovering or selecting a **section** opens its entries in a flyout panel beside the rail. The panel is fully keyboard-driven: selecting a section moves focus into it, the arrow keys walk the entries, **Enter** opens one, and **Escape** closes the panel and puts focus back where it was.
- The icon of the section holding your **current page** stays highlighted, and the flyout marks the exact row, so you never lose your place.
- Badges shrink to small marks on the row icon: the `NEW` flame, the `BETA` seedling, and a padlock for license-locked entries. See [Menu Badges](/navigation/pro__menu_badges/).
- The magnifying glass under the logo keeps a mouse path to [Global Search](#searching); the keyboard shortcut works as always.

The rail also follows your page as you navigate: opening a page that lives inside a menu group opens that group (expanded) or lights its section (collapsed), including when you arrive from a bookmark or a link.

## Sensei + AI

The AI capabilities sit together in their own section rather than being spread through the dashboards.
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading