align Connections terminology across glossary, feature lists, and comparison tables

paulOsinski · paulOsinski · commit 80c20835ac1e · 2026-07-16T14:44:12.000-04:00
diff --git a/docs/content/asset_modelling/engagements_tests/OS__assets.md b/docs/content/asset_modelling/engagements_tests/OS__assets.md
@@ -175,6 +175,6 @@ In practice, Assets should be defined to reflect how systems are built and deplo
 
 Assets can be mapped directly to Jira Projects, which push the Asset’s Findings into a Jira instance.
 
-Because Findings inherit risk, priority, and ownership from their parent Asset, the Asset effectively determines the remediation context that flows into Jira tickets and Integrator workflows.
+Because Findings inherit risk, priority, and ownership from their parent Asset, the Asset effectively determines the remediation context that flows into Jira tickets and Downstream Connection workflows.
 
 Importantly, Assets are also the primary determining factor in a Finding’s SLA characteristics. Therefore, the SLA of a Findings depends on the SLA configuration of its parent Asset. More information about SLA configurations can be found [here](/asset_modelling/os_hierarchy/os__sla_configuration/#main-content). 
diff --git a/docs/content/asset_modelling/engagements_tests/PRO__assets.md b/docs/content/asset_modelling/engagements_tests/PRO__assets.md
@@ -166,11 +166,11 @@ In DefectDojo Pro, Findings inherit their SLA targets, Priority, and Risk from t
 
 This means that the same vulnerability may receive a different Priority or Risk score depending on whether it affects an internal development system or a production asset supporting critical business operations.
 
-### Jira / Integrators Relationships
+### Jira / Downstream Connection Relationships
 
 Assets can be mapped directly to [Jira](/connections/downstream/pro__jira_guide/#main-content) or [Integrators](/connections/downstream/downstream_toolreference/#main-content) instances (e.g. GitHub, GitLab, ServiceNow, etc.), which push the Asset’s Findings outward into external ticketing/work-management systems.
 
-Because Findings inherit risk, priority, and ownership from their parent Asset, the Asset effectively determines the remediation context that flows into Jira tickets and Integrator workflows.
+Because Findings inherit risk, priority, and ownership from their parent Asset, the Asset effectively determines the remediation context that flows into Jira tickets and Downstream Connection workflows.
 
 Importantly, Assets are also the primary determining factor in a Finding’s SLA characteristics. Therefore, the SLA of a Findings depends on the SLA configuration of its parent Asset. More information about SLA configurations can be found [here](/asset_modelling/pro_hierarchy/priority_sla/#working-with-slas).
 
diff --git a/docs/content/get_started/about/defectdojo_versions.md b/docs/content/get_started/about/defectdojo_versions.md
@@ -20,9 +20,9 @@ weight: 1
 | Dashboards & reporting | ✔️ Basic dashboards and reports | ✔️ Advanced, customizable dashboards and executive reporting |
 | Automation & workflows | ❌ Not included | ✔️ Rules Engine and automated workflows |
 | Import enhancements | ❌ Standard imports only | ✔️ Background imports, Smart Upload, Universal Parser, CLI uploads |
-| Tool integrations | ❌ Manual/API-driven | ✔️ Built-in **API Connectors** for popular AppSec and cloud tools |
+| Tool integrations | ❌ Manual/API-driven | ✔️ Built-in **Upstream Connections** (API Connectors) for popular AppSec and cloud tools |
 | Jira integration | ✔️ Included | ✔️ Included |
-| Project management integrations | ❌ Not included | ✔️ integrate with **Azure Devops**, **GitHub**, **GitLab** and **ServiceNow** |
+| Project management integrations | ❌ Not included | ✔️ **Downstream Connections** to **Jira**, **Azure DevOps**, **GitHub**, **GitLab**, **ServiceNow**, **Bitbucket**, **Shortcut**, **Zendesk**, **ServiceDesk Plus** and **Freshservice** |
 | Finding enhancements | ❌ Not included | ✔️ Automatic KEV, EPSS scoring and Ransomware tracking |
 | SOC & AppSec unification | ❌ AppSec-focused only | ✔️ Unified AppSec and SOC findings |
 | AI & next-generation features | ❌ Not included | ✔️ AI-assisted workflows, reporting and MCP support |
diff --git a/docs/content/get_started/about/ui_pro_vs_os.md b/docs/content/get_started/about/ui_pro_vs_os.md
@@ -13,7 +13,7 @@ The Pro UI brings the following enhancements to DefectDojo:
 
 - Modern and sleek design using Vue.js.
 - Optimized data delivery and load times, especially for large datasets.
-- Access to new Pro features, including [API Connectors](/connections/upstream/about/), [Universal Importer](/import_data/pro/specialized_import/external_tools/), and [Pro Metrics](https://docs.defectdojo.com/metrics_reports/pro_metrics/pro__overview/) views.
+- Access to new Pro features, including [Upstream Connections (API Connectors)](/connections/upstream/about/), [Universal Importer](/import_data/pro/specialized_import/external_tools/), and [Pro Metrics](https://docs.defectdojo.com/metrics_reports/pro_metrics/pro__overview/) views.
 - Improved UI workflows: better filtering, dashboards, and navigation.
 
 ## Switching To The Pro UI
@@ -30,11 +30,11 @@ To access the Pro UI, open your User Options menu from the top-right hand corner
 
 2. The Homepage, [AI-powered native API connection capabilities](/metrics_reports/ai/mcp_server_pro/), Pro Metrics, and the Calendar view are all accessible under Dashboards.
 
-4. Import methods can be found in the Import section: set up [API Connectors](/connections/upstream/about/), use the [Add Findings](/import_data/import_scan_files/pro__import_scan_ui/) form to Add Findings, use [Smart Upload](/import_data/pro/specialized_import/smart_upload/) to handle infrastructure scanning tools, or use our external tools—[Universal Importer and DefectDojo CLI](/import_data/pro/specialized_import/external_tools/)—to streamline both the import and reimport processes of Findings and associated objects.
+4. Import methods can be found in the Import section: set up [Connections](/connections/about/) to pull findings in from your scanners (Upstream) or push them out to issue trackers (Downstream), use the [Add Findings](/import_data/import_scan_files/pro__import_scan_ui/) form to Add Findings, use [Smart Upload](/import_data/pro/specialized_import/smart_upload/) to handle infrastructure scanning tools, or use our external tools—[Universal Importer and DefectDojo CLI](/import_data/pro/specialized_import/external_tools/)—to streamline both the import and reimport processes of Findings and associated objects.
 
 5. The **Manage** section allows you to view different objects in the [Product Hierarchy](/asset_modelling/os_hierarchy/product_hierarchy/), with views for Product Types, Products, Engagements, Tests, Findings, Risk Acceptances, Endpoints, and Components.  There are additional sections for generating reports (Report Builder), using surveys (Surveys), as well as a [Rules Engine](/automation/rules_engine/about/). 
 
-5. The **Settings** section allows you to configure your DefectDojo instance, including your Integrations, License, Cloud Settings, Users, Feature Configuration and admin-level Enterprise Settings.
+5. The **Settings** section allows you to configure your DefectDojo instance, including your License, Cloud Settings, Users, Feature Configuration and admin-level Enterprise Settings. (Integrations have moved to **Import > Connections > Downstream Connections**.)
 
 6. The **Pro Settings** section contains the System Settings, Banner Settings, Notification Settings, Jira Instances, Deduplication Settings, and Authentication Settings, including SAML, OIDC, OAuth, Login, and MFA forms.
 
@@ -58,4 +58,4 @@ New Metrics visualizations are included in the Pro UI. All of these reports can
 - **Priority Insights** show the most critical findings with the option to filter for various timelines, Product Types, Products, and Tags.
 - The **Program Insights** dashboard displays the effectiveness of your security team and the cost savings associated with separating duplicates and false positives from actionable Findings.
 - **Remediation Insights** displays your team's effectiveness at remediating Findings.
-- **Tool Insights** displays the effectiveness of your tool suite (and Connectors pipelines) at detecting and reporting vulnerabilities.
+- **Tool Insights** displays the effectiveness of your tool suite (and Upstream Connection pipelines) at detecting and reporting vulnerabilities.
diff --git a/docs/content/get_started/pro/pro_features.md b/docs/content/get_started/pro/pro_features.md
@@ -59,7 +59,7 @@ See our [Deduplication Tuning Guide](/triage_findings/finding_deduplication/pro_
 
 ### More Import Options
 
-DefectDojo Pro includes four additional import methods: [Universal Importer](/import_data/pro/specialized_import/external_tools/), [API Connectors](/connections/upstream/about/), [Universal Parser](/supported_tools/parsers/universal_parser/), and [Smart Upload](/import_data/pro/specialized_import/smart_upload/).
+DefectDojo Pro includes four additional import methods: [Universal Importer](/import_data/pro/specialized_import/external_tools/), [Upstream Connections (API Connectors)](/connections/upstream/about/), [Universal Parser](/supported_tools/parsers/universal_parser/), and [Smart Upload](/import_data/pro/specialized_import/smart_upload/).
 
 ![image](images/pro_import_methods.png)
 
@@ -74,15 +74,15 @@ Quickly build a command-line pipeline to import, reimport, and export data to yo
 
 See our [External Tools Guide](/import_data/pro/specialized_import/external_tools/) for more information.
 
-### Connectors
+### Upstream Connections
 
 DefectDojo can instantly connect to enterprise-level scanning tools to import new Finding data, creating an automated Import pipeline that works out-of-the-box without the need to set up any API calls or cron jobs. 
 
-See our [Connectors Guide](/connections/upstream/about/) for more information.
+See our [Upstream Connections Guide](/connections/upstream/about/) for more information.
 
 ![image](images/add_edit_connectors_2.png)
 
-Supported tools for Connectors include:
+Supported tools for Upstream Connections include:
 
 * Anchore
 * AWS Security Hub
diff --git a/docs/content/help/glossary.md b/docs/content/help/glossary.md
@@ -57,8 +57,12 @@ A permission set defining allowed actions within DefectDojo. Roles enforce acces
 A flexible ingestion mechanism that allows scan data to be imported without a tool-specific importer. It relies on normalized field mapping rather than predefined scanner schemas.
 ## DefectDojo-CLI (Pro)
 A command-line interface used to interact with DefectDojo programmatically. The CLI is commonly used in CI/CD pipelines to automate scan uploads and object management.
-## API Connectors (Pro)
-Prebuilt, managed integrations that connect DefectDojo with external platforms (e.g., ticketing, messaging, or DevOps tools). API Connectors reduce the need for custom scripting.
+## Connections (Pro)
+The unified area of the Pro UI (under Import) for every tool DefectDojo talks to. Upstream Connections pull findings in from scanners; Downstream Connections push findings out to issue trackers.
+## Upstream Connections / API Connectors (Pro)
+Prebuilt, managed connectors that pull findings and asset inventory into DefectDojo from external scanners and security tools via their APIs, reducing the need for custom scripting. Formerly called API Connectors.
+## Downstream Connections (Pro)
+Managed integrations that push Findings and Finding Groups out of DefectDojo into issue tracking and ticketing systems (e.g., Jira, Azure DevOps, GitHub). Formerly called Integrations.
 ## Universal Parser (Pro)
 A generalized parsing engine used by the Universal Importer to interpret incoming scan data. It applies consistent normalization and deduplication logic across unsupported formats.
 ## Smart Upload (Pro)
