diff --git a/docs/internal-developer-portal/layout-and-appearance/sidenav.md b/docs/internal-developer-portal/layout-and-appearance/sidenav.md index 5c82f5ee008..9eb226860ef 100644 --- a/docs/internal-developer-portal/layout-and-appearance/sidenav.md +++ b/docs/internal-developer-portal/layout-and-appearance/sidenav.md @@ -95,3 +95,35 @@ If you have built a [Custom Plugin](/docs/internal-developer-portal/plugins/cust to: EntityMyCustomPluginPage text: MyPlugin ``` + +## Embedding an Iframe + +You can embed an iframe inside the sidenav layout to display external web content directly within your Harness IDP. + +![](./static/iframe-embedd.png) + +#### Steps to Add an Iframe + +1. Navigate to the sidenav layout page. +2. Add a YAML block similar to the example below: + +```yaml +- name: SidebarItem + type: iframe + props: + to: iframe/developer_docs + text: Developer docs + url: https://developer.harness.io/ +``` + +When configuring the iframe SidebarItem: + +* Use `type: iframe` to specify an iframe element (case-insensitive, so `IfRAmE` also works) +* Configure these properties under `props`: + * `to`: Must follow the format `iframe/${path}` where `${path}` is your custom path segment (this `path` is a unique path i.e. every sidebar item being added must be unique) + * `text`: The label that appears in the sidebar navigation + * `url`: The external URL you want to display within the iframe + +:::info +iframes come with certain inherent limitations — for example, OAuth will not work and some websites put limits or block themselves from being rendered inside iframes. +::: diff --git a/docs/internal-developer-portal/layout-and-appearance/static/iframe-embedd.png b/docs/internal-developer-portal/layout-and-appearance/static/iframe-embedd.png new file mode 100644 index 00000000000..cff77d623e7 Binary files /dev/null and b/docs/internal-developer-portal/layout-and-appearance/static/iframe-embedd.png differ diff --git a/release-notes/internal-developer-portal.md b/release-notes/internal-developer-portal.md index 405f8755961..029debe623c 100644 --- a/release-notes/internal-developer-portal.md +++ b/release-notes/internal-developer-portal.md @@ -27,6 +27,28 @@ Review the notes below for details about recent changes to Harness Internal Deve | [2025.08.v1](/release-notes/internal-developer-portal#august---202508v1) | ✅ | ✅ | ✅ | ⏳| ⏳ | ⏳ | +### [New Feature] Iframe Embedding in Sidebar Navigation + +Harness IDP now supports embedding external web content directly into your sidebar navigation using iframes. This feature allows you to integrate essential resources, documentation, dashboards, and tools directly into your developer portal interface. + +* **External Content Integration** - Add documentation, dashboards, or any web content directly in your IDP navigation +* **Simple YAML Configuration** - Easy to implement with standard sidebar navigation format + +#### Example Configuration + +```yaml +- name: SidebarItem + type: iframe + props: + to: iframe/developer_docs + text: Developer docs + url: https://developer.harness.io/ +``` + +![](./static/internal-developer-portal/iframe-embedd.png) + +[Learn more about embedding iframes in your sidebar](/docs/internal-developer-portal/layout-and-appearance/sidenav#embedding-an-iframe) + ### Bug Fixes and Improvements * **Jira Plugin Enhancements** - We've made several improvements to the Jira plugin: @@ -229,7 +251,6 @@ The [DX plugin configuration](https://developer.harness.io/docs/internal-develop - ### [New Feature] Harness Feature Management & Experimentation Plugin Harness IDP now includes a native integration with Harness Feature Management & Experimentation (FME), allowing teams to view and manage feature flags directly in their service catalog. @@ -242,6 +263,8 @@ Harness IDP now includes a native integration with Harness Feature Management & [Learn more about the Harness FME Plugin](/docs/internal-developer-portal/plugins/available-plugins/harness-native-plugins/harness-fme) + + ### Bug Fixes and Improvements * **New Catalog APIs** - Harness IDP now includes two new APIs to make it easier to find and display catalog entities: diff --git a/release-notes/static/internal-developer-portal/iframe-embedd.png b/release-notes/static/internal-developer-portal/iframe-embedd.png new file mode 100644 index 00000000000..cff77d623e7 Binary files /dev/null and b/release-notes/static/internal-developer-portal/iframe-embedd.png differ