airbytehq · ian-at-airbyte · Sep 25, 2025 · Sep 11, 2025 · Sep 13, 2025 · Sep 13, 2025
diff --git a/docs/ai-agents/assets/embedded-workspaces.png b/docs/ai-agents/assets/embedded-workspaces.png
diff --git a/docs/ai-agents/embedded/widget/assets/embedded-workspaces.png b/docs/ai-agents/embedded/widget/assets/embedded-workspaces.png
diff --git a/docs/ai-agents/embedded/widget/managing-embedded.md b/docs/ai-agents/embedded/widget/managing-embedded.md
@@ -10,7 +10,6 @@ Airbyte Embedded is built upon the Airbyte Platform. As the owner of your embedd
 
 ![Selected workspaces.](./assets/embedded-workspaces.png)
 
-
 ## Enabling Connectors within the Widget
 
 Source connectors can be configured to appear in the Embedded widget by creating a configuration template [via the source_template endpoint](https://api.airbyte.ai/api/v1/docs#tag/Template-Sources/operation/create_integrations_templates_sources).

diff --git a/docs/integrations/custom-connectors.md b/docs/integrations/custom-connectors.md
@@ -38,6 +38,14 @@ See the following guides for more information on building custom Airbyte Docker
 
 ## Upgrading a connector
 
+Follow these steps to upgrade a connector version.
+
+1. In the navigaton bar, click **Workspace settings** > **Sources**/**Destinations**.
+
+2. Find your connector in the list and click the edit button <svg fill="none" data-icon="pencil" role="img" viewBox="0 0 24 24" class="inline-svg"><path fill="currentColor" d="M22 7.24a1 1 0 0 0-.29-.71l-4.24-4.24a1 1 0 0 0-.71-.29 1 1 0 0 0-.71.29l-2.83 2.83L2.29 16.05a1 1 0 0 0-.29.71V21a1 1 0 0 0 1 1h4.24a1 1 0 0 0 .76-.29l10.87-10.93L21.71 8q.138-.146.22-.33.015-.12 0-.24a.7.7 0 0 0 0-.14zM6.83 20H4v-2.83l9.93-9.93 2.83 2.83zM18.17 8.66l-2.83-2.83 1.42-1.41 2.82 2.82z"></path></svg>.
+
+3. In the dialog, update the Docker image tag to the new version.
+
 To upgrade your connector version, go to the Settings in the left hand side of the UI and navigate to either Sources or Destinations. Find your connector in the list, and input the latest connector version.
 
 ![](/.gitbook/assets/upgrade-connector-version.png)
@@ -9,33 +9,9 @@ However, due to differences between the Python and low-code CDKs, this migration
 
 This release introduces an updated data type of the `name` field in the `events` stream. Users will need to reset this stream after upgrading.
 
-## Connector Upgrade Guide
+## Connector upgrade guide
 
-### For Airbyte Open Source: Update the local connector image
-
-Airbyte Open Source users must manually update the connector image in their local registry before proceeding with the migration. To do so:
-
-1. Select **Settings** in the main navbar.
-   1. Select **Sources**.
-2. Find Gitlab in the list of connectors.
-
-:::note
-You will see two versions listed, the current in-use version and the latest version available.
-:::
-
-3. Select **Change** to update your OSS version to the latest available version.
-
-### Update the connector version
-
-1. Select **Sources** in the main navbar.
-2. Select the instance of the connector you wish to upgrade.
-
-:::note
-Each instance of the connector must be updated separately. If you have created multiple instances of a connector, updating one will not affect the others.
-:::
-
-3. Select **Upgrade**
-   1. Follow the prompt to confirm you are ready to upgrade to the new version.
+[Help with upgrades](/platform/managing-airbyte/connector-updates).
 
 ### Refresh affected schemas and reset data
 

@@ -14,17 +14,7 @@ Users will need to reset the affected streams after upgrading.
 
 ### For Airbyte Open Source: Update the local connector image
 
-Airbyte Open Source users must manually update the connector image in their local registry before proceeding with the migration. To do so:
-
-1. Select **Settings** in the main navbar.
-   1. Select **Sources**.
-2. Find Gitlab in the list of connectors.
-
-:::note
-You will see two versions listed, the current in-use version and the latest version available.
-:::
-
-3. Select **Change** to update your OSS version to the latest available version.
+If you're a self-managed user, manually update the connector image in your local registry before proceeding with the migration. [Help with this](/platform/next/managing-airbyte/connector-updates).
 
 ### Update the connector version
 
@@ -62,33 +52,9 @@ For more information on resetting your data in Airbyte, see [this page](/platfor
 In this release, `merge_request_commits` stream schema has been fixed so that it returns commits for each merge_request.
 Users will need to refresh the source schema and reset `merge_request_commits` stream after upgrading.
 
-## Connector Upgrade Guide
-
-### For Airbyte Open Source: Update the local connector image
-
-Airbyte Open Source users must manually update the connector image in their local registry before proceeding with the migration. To do so:
-
-1. Select **Settings** in the main navbar.
-   1. Select **Sources**.
-2. Find Gitlab in the list of connectors.
-
-:::note
-You will see two versions listed, the current in-use version and the latest version available.
-:::
+## Connector upgrade guide
 
-3. Select **Change** to update your OSS version to the latest available version.
-
-### Update the connector version
-
-1. Select **Sources** in the main navbar.
-2. Select the instance of the connector you wish to upgrade.
-
-:::note
-Each instance of the connector must be updated separately. If you have created multiple instances of a connector, updating one will not affect the others.
-:::
-
-3. Select **Upgrade**
-   1. Follow the prompt to confirm you are ready to upgrade to the new version.
+[Help with upgrades](/platform/managing-airbyte/connector-updates).
 
 ### Refresh affected schemas and reset data
 

@@ -11,14 +11,7 @@ Users who do not have this stream enabled will not be affected and can safely up
 3. Disable the `pull_requests` stream
 4. In the main navbar, navigate to the **Sources** tab and select the affected Jira source. Set the `enable_experimental_streams` field to false and save your changes.
 
-:::note
-For **OSS users**, the **Pull Request** stream can still be synced by pinning this source to an earlier version:
-
-1. Select **Settings** in the main navbar.
-2. Select **Sources**, edit the entry for `source-jira` and set the **Default Version** to `3.5.4`
-
-This feature is not available in **Airbyte Cloud**
-:::
+If you're a self-managed user and can't upgrade to the new version yet, you can pin the connector to a specific version. [Help managing upgrades](/platform/next/managing-airbyte/connector-updates).
 
 ## Upgrading to 3.0.0
 

@@ -4,33 +4,9 @@
 
 Source Metabase has updated the `dashboards` stream's endpoint due to the previous endpoint being deprecated by the service. The new version no longer returns the `creator` field for the `dashboards` stream.
 
-## Connector Upgrade Guide
+## Connector upgrade guide
 
-### For Airbyte Open Source: Update the local connector image
-
-Airbyte Open Source users must manually update the connector image in their local registry before proceeding with the migration. To do so:
-
-1. Select **Settings** in the main navbar.
-   1. Select **Sources**.
-2. Find Metabase in the list of connectors.
-
-:::note
-You will see two versions listed, the current in-use version and the latest version available.
-:::
-
-3. Select **Change** to update your OSS version to the latest available version.
-
-### Update the connector version
-
-1. Select **Sources** in the main navbar.
-2. Select the instance of the connector you wish to upgrade.
-
-:::note
-Each instance of the connector must be updated separately. If you have created multiple instances of a connector, updating one will not affect the others.
-:::
-
-3. Select **Upgrade**
-   1. Follow the prompt to confirm you are ready to upgrade to the new version.
+[Help with upgrades](/platform/managing-airbyte/connector-updates).
 
 ### Refresh affected schemas and reset data
 

@@ -13,33 +13,9 @@ To gracefully handle these changes for your existing connections, we highly reco
 To add start date filtering for the `Cohorts`, `CohortMembers`, and `Engage` streams, the default retrieval range has been updated from all existing records to only include records created within the past year if start date not provided.
 :::
 
-## Migration Steps
+## Connector upgrade guide
 
-### For Airbyte Open Source: Update the local connector image
-
-Airbyte Open Source users must manually update the connector image in their local registry before proceeding with the migration. To do so:
-
-1. Select **Settings** in the main navbar.
-   1. Select **Sources**.
-2. Find `Mixpanel` in the list of connectors.
-
-:::note
-You will see two versions listed, the current in-use version and the latest version available.
-:::
-
-3. Select **Change** to update your OSS version to the latest available version.
-
-### Update the connector version
-
-1. Select **Sources** in the main navbar.
-2. Select the instance of the connector you wish to upgrade.
-
-:::note
-Each instance of the connector must be updated separately. If you have created multiple instances of a connector, updating one will not affect the others.
-:::
-
-3. Select **Upgrade**
-   1. Follow the prompt to confirm you are ready to upgrade to the new version.
+[Help with upgrades](/platform/managing-airbyte/connector-updates).
 
 ### Refresh affected schemas and reset data
 

@@ -4,33 +4,9 @@
 
 Source Monday has deprecated API version 2023-07. We have upgraded the connector to the latest API version 2024-01. In this new version, the Id field has changed from an integer to a string in the streams Boards, Items, Tags, Teams, Updates, Users and Workspaces. Please reset affected streams.
 
-## Connector Upgrade Guide
+## Connector upgrade guide
 
-### For Airbyte Open Source: Update the local connector image
-
-Airbyte Open Source users must manually update the connector image in their local registry before proceeding with the migration. To do so:
-
-1. Select **Settings** in the main navbar.
-   1. Select **Sources**.
-2. Find Monday in the list of connectors.
-
-:::note
-You will see two versions listed, the current in-use version and the latest version available.
-:::
-
-3. Select **Change** to update your OSS version to the latest available version.
-
-### Update the connector version
-
-1. Select **Sources** in the main navbar.
-2. Select the instance of the connector you wish to upgrade.
-
-:::note
-Each instance of the connector must be updated separately. If you have created multiple instances of a connector, updating one will not affect the others.
-:::
-
-3. Select **Upgrade**
-   1. Follow the prompt to confirm you are ready to upgrade to the new version.
+[Help with upgrades](/platform/managing-airbyte/connector-updates).
 
 ### Refresh schemas and reset data
 

@@ -21,33 +21,9 @@ This change will affect the following streams:
 
 To gracefully handle these changes for your existing connections, we highly recommend resetting your data before resuming your data syncs with the new version.
 
-## Migration Steps
+## Connector upgrade guide
 
-### For Airbyte Open Source: Update the local connector image
-
-Airbyte Open Source users must manually update the connector image in their local registry before proceeding with the migration. To do so:
-
-1. Select **Settings** in the main navbar.
-   1. Select **Sources**.
-2. Find Pinterest in the list of connectors.
-
-:::note
-You will see two versions listed, the current in-use version and the latest version available.
-:::
-
-3. Select **Change** to update your OSS version to the latest available version.
-
-### Update the connector version
-
-1. Select **Sources** in the main navbar.
-2. Select the instance of the connector you wish to upgrade.
-
-:::note
-Each instance of the connector must be updated separately. If you have created multiple instances of a connector, updating one will not affect the others.
-:::
-
-3. Select **Upgrade**
-   1. Follow the prompt to confirm you are ready to upgrade to the new version.
+[Help with upgrades](/platform/managing-airbyte/connector-updates).
 
 ### Refresh affected schemas and reset data
 

diff --git a/docs/integrations/sources/postgres/assets/airbyte_postgres_source.png b/docs/integrations/sources/postgres/assets/airbyte_postgres_source.png
diff --git a/docs/integrations/sources/postgres/assets/airbyte_source_selection.png b/docs/integrations/sources/postgres/assets/airbyte_source_selection.png
Original file line number	Diff line number	Diff line change
Expand Up		@@ -10,7 +10,6 @@ Airbyte Embedded is built upon the Airbyte Platform. As the owner of your embedd

		![Selected workspaces.](./assets/embedded-workspaces.png)


		## Enabling Connectors within the Widget

		Source connectors can be configured to appear in the Embedded widget by creating a configuration template [via the source_template endpoint](https://api.airbyte.ai/api/v1/docs#tag/Template-Sources/operation/create_integrations_templates_sources).
Expand Down