automation: Docs update for OpenHands v1.26.0 release

Start by reviewing the release checklist and suggested documentation locations in the issue, then inspect the referenced pages: canvas-extensions.mdx, specs/canvas-extensions.md, backends.mdx, troubleshooting.mdx, first-time-setup.mdx, and managing-automations.mdx. Confirm the user-facing changes against the linked pull requests and resolve the items marked for maintainer confirmation. Done means updating the relevant docs and adding the proposed v1.26.0 release-notes page and navigation entry, with the checklist accurately reflecting what needs documentation.

Release

• Version: v1.26.0
• Published: 2026-10-08T20:36:10Z
• URL: https://github.com/OpenHands/OpenHands/releases/tag/v1.26.0
• Prerelease: no

Release summary

OpenHands 1.26.0 (Agent Canvas) adds an authenticated backend view helper for Canvas Apps, renders the SDK's empty-response corrective nudge as an informational note in chat, explains a suspended cloud/Enterprise workspace and offers a switch, shows the Super Admin setup guide on enterprise backends and advances the getting-started checklist when a step completes, and narrows the automations "Needs review" status to explicit unrecognized task outcomes. The remainder is a large batch of Canvas UI, accessibility, and error-message fixes, cloud polling/org-scoping fixes, a telemetry Do-Not-Track fix, a macOS desktop title-bar fix, Docker runtime-package trimming, the verify-openhands agent skill, and test/maintenance work.

Documentation review checklist

• feat(apps): authenticated backend view helper for Canvas Apps (#17656) — documentation needed: document that Canvas Apps can request an authenticated backend view. Review canvas-extensions.mdx (Apps (Beta)) and specs/canvas-extensions.md; confirm the public-facing behavior. Source: https://github.com/OpenHands/OpenHands/pull/17656
• feat(chat): render empty-response corrective nudge as an informational note (#17864) — probably no documentation change: an internal chat rendering change. Consider a line in the v1.26.0 release-notes highlights only if maintainers want it surfaced. Source: https://github.com/OpenHands/OpenHands/pull/17864
• feat(backends): explain a suspended workspace and offer a switch (#17988) — documentation needed: describe the suspended-organization/membership screen and workspace switching on cloud/Enterprise backends. Candidate pages: backends.mdx, troubleshooting.mdx, and the cloud organizations area. Source: https://github.com/OpenHands/OpenHands/pull/17988
• feat(onboarding): show the Super Admin setup guide on enterprise backends (#17969) — documentation needed: describe the Super Admin setup guide panel shown in Canvas on enterprise backends, its n/4 steps, and its OHE links. Candidate page: first-time-setup.mdx (and enterprise onboarding). Source: https://github.com/OpenHands/OpenHands/pull/17969
• feat(onboarding): open the next setup guide step when one is done in Canvas (#18138) — documentation needed: document that completing a step advances the guide, and how it interacts with the "Getting started" checklist. Candidate page: first-time-setup.mdx. Source: https://github.com/OpenHands/OpenHands/pull/18138
• feat(automations): narrow needs review status (#17682) — documentation needed: update the run status descriptions so completed runs without a task outcome default to a successful badge and only explicit unrecognized statuses map to "Needs review". Candidate page: managing-automations.mdx (Run Statuses). Source: https://github.com/OpenHands/OpenHands/pull/17682
• feat: verify-openhands skill with control-openhands CLI and the full feature map (#17961, #18093, #18105, #18162) — probably no documentation change: internal agent verification tooling under .agents/skills/. Source: https://github.com/OpenHands/OpenHands/pull/17961
• fix: reduce cloud org and git installation polling (#18128) — probably no documentation change: client polling behavior only. Source: https://github.com/OpenHands/OpenHands/pull/18128
• fix: cloud conversation org scoping (#18130) — probably no documentation change: internal cloud request scoping. Source: https://github.com/OpenHands/OpenHands/pull/18130
• fix: cloud sandbox resume retry behavior (#17665) — needs maintainer confirmation: may be worth a troubleshooting note on cloud sandbox resume if the behavior is user-observable. Source: https://github.com/OpenHands/OpenHands/pull/17665
• fix(canvas): hide unavailable cloud VS Code action (#18149) — probably no documentation change: hides a UI action that was not available. Source: https://github.com/OpenHands/OpenHands/pull/18149
• fix(docker): minimize Canvas runtime packages (#18134) — needs maintainer confirmation: confirm whether the reduced runtime packages change any self-hosting prerequisite or documented dependency. Source: https://github.com/OpenHands/OpenHands/pull/18134
• fix(telemetry): never initialize PostHog under Do Not Track (#18086) — needs maintainer confirmation: check whether the privacy/telemetry documentation states Do-Not-Track behavior. Source: https://github.com/OpenHands/OpenHands/pull/18086
• fix(desktop): restore the macOS title bar drag region (#17474) — probably no documentation change: desktop shell fix. Source: https://github.com/OpenHands/OpenHands/pull/17474
• Canvas UI, accessibility, and error-toast fixes (#18018, #18019, #18021, #18022, #18023, #18024, #18025, #18026, #18027, #18028, #18030, #18031, #18032, #18033, #18034, #18035, #18036, #18037, #18039, #18040, #18041, #18043, #18044, #18045, #18051, #18095, #18010, #17910, #17911) — probably no documentation change: UI polish, keyboard/Escape behavior, copy, and error-message fixes. Source: https://github.com/OpenHands/OpenHands/pull/18019
• refactor(canvas): remove bundled VS Code consumer assumptions (#17660) and revert: restore bundled VS Code consumer support (#18048) — probably no documentation change: the refactor was reverted in the same release, so bundled VS Code support is unchanged. Source: https://github.com/OpenHands/OpenHands/pull/18048
• Maintenance and tests (#18006 lint, #16574 test sweep, #18084/#18087/#18079/#18122/#18121 e2e) — probably no documentation change: internal lint, test, and CI work. Source: https://github.com/OpenHands/OpenHands/pull/16574
• Documentation (#18085, #18141 verify-openhands mapping) — probably no documentation change in this repo: internal mapping docs. Source: https://github.com/OpenHands/OpenHands/pull/18141

Pull request review

• https://github.com/OpenHands/OpenHands/pull/17988 — Adds a suspended-workspace screen for cloud/Enterprise backends: detects a 403 with the organization/membership suspension detail, replaces the app with a message, and offers buttons to switch to another workspace. Touches src/api/cloud/proxy.ts, src/api/cloud/organization-suspension-store.ts, src/components/features/backends/cloud-organization-boundary.tsx, and i18n strings (15 languages). User-facing; docs recommended.
• https://github.com/OpenHands/OpenHands/pull/17969 — Shows the Super Admin setup guide panel in Canvas on enterprise backends when /me lists manage_super_admins, mirroring the OHE guide's steps and progress, and hides the "Getting started" checklist while it is shown. Touches src/components/features/setup-guide/* and i18n. User-facing; docs recommended.
• https://github.com/OpenHands/OpenHands/pull/18138 — Advances the setup guide to the next step when a step completes in Canvas. Touches setup-guide components/constants and i18n. User-facing; docs recommended.
• https://github.com/OpenHands/OpenHands/pull/17682 — Narrows "Needs review": completed runs with no task outcome default to a successful badge, explicit unrecognized statuses stay "Needs review", and outcome_summary is preserved. Touches src/utils/automation-run-display.ts and run-logs/home/insights consumers. User-facing; docs recommended for the run status descriptions.
• https://github.com/OpenHands/OpenHands/pull/17656 — Adds an authenticated backend view helper for Canvas Apps. Touches src/extensions/canvas-extension-app-view.ts, src/api/canvas-extensions-service.ts, src/types/canvas-extension.ts, and specs/canvas-extensions.md. Likely user-facing for app authors; docs review recommended.
• https://github.com/OpenHands/OpenHands/pull/17864 — Renders the SDK empty-response corrective nudge as an informational inline note instead of a regular chat message. Touches chat event rendering and a focused test. Internal rendering; no docs impact found beyond an optional release-notes mention.
• https://github.com/OpenHands/OpenHands/pull/18128 — Reduces polling for cloud org and git installation queries. Touches React Query hooks and the cloud new-conversation menu. No docs impact found.
• https://github.com/OpenHands/OpenHands/pull/18130 — Fixes cloud conversation org scoping. Touches src/api/cloud/proxy.ts and conversation query hooks. No docs impact found.
• https://github.com/OpenHands/OpenHands/pull/17665 — Adjusts cloud sandbox resume retry behavior and suppresses auto-resume in some cases. Touches src/api/cloud/cloud-sandbox-resume-suppression.ts and mutation hooks. Possible troubleshooting relevance; maintainer confirmation requested.
• https://github.com/OpenHands/OpenHands/pull/18149 — Hides the cloud VS Code action when unavailable. Touches src/hooks/query/use-unified-vscode-url.ts. No docs impact found.
• https://github.com/OpenHands/OpenHands/pull/18134 — Minimizes Docker runtime packages. Touches docker/Dockerfile and a runtime-packages test. Maintainer confirmation requested for self-hosting docs.
• https://github.com/OpenHands/OpenHands/pull/18086 — Never initializes PostHog under Do Not Track. Touches src/services/telemetry.ts. Possible privacy/telemetry docs relevance; maintainer confirmation requested.
• https://github.com/OpenHands/OpenHands/pull/17474 — Restores the macOS title bar drag region in the desktop shell. Touches electron/*, src/routes/root-layout.tsx, src/utils/desktop-shell.ts. No docs impact found.
• https://github.com/OpenHands/OpenHands/pull/17660 and https://github.com/OpenHands/OpenHands/pull/18048 — The bundled VS Code consumer refactor was reverted by #18048; net user-facing behavior unchanged. No docs impact found.
• https://github.com/OpenHands/OpenHands/pull/17961, https://github.com/OpenHands/OpenHands/pull/18093, https://github.com/OpenHands/OpenHands/pull/18105, https://github.com/OpenHands/OpenHands/pull/18162 — verify-openhands agent skill and feature map under .agents/skills/. Internal tooling; no docs impact found.

Human testing required

• Suspended workspace screen (#17988) — against an OpenHands Enterprise instance with ENABLE_SUPER_ADMIN=true, suspend an organization, sign in as a member with that organization selected, and open /canvas. Expected verification: the app is replaced by "…is suspended. Contact your administrator…" plus a button for each other workspace; choosing one loads the app there; suspending only the membership shows the membership message; a Super Admin selecting the suspended organization sees no suspension screen. A human must confirm the exact wording and behavior.
• Super Admin setup guide (#17969, #18138) — on an enterprise backend whose first Super Admin has the guide enabled, open /canvas. Expected verification: a collapsible guide panel appears with the same steps, order, and n/4 progress as OHE; completing a step in Canvas ticks it; the "Getting started" checklist is hidden while the guide is shown; non-super-admins and local backends see no guide. A human must confirm placement and link targets.
• Automations "Needs review" narrowing (#17682) — create or inspect a completed automation run whose finish response omits status. Expected verification: the run shows a successful badge, while an explicit unrecognized status string still shows "Needs review". A human must confirm the displayed labels in the Automations dashboard, run logs, and home health metrics.
• Corrective nudge rendering (#17864) — the empty-response path cannot be produced on demand from a live LLM. Expected verification: when the SDK injects the corrective nudge, chat shows an informational inline note with an info icon rather than a plain assistant message. A human with the mock-LLM path should confirm the rendered style.

Suggested documentation locations

• New page openhands/usage/agent-canvas/release-notes/v1.26.0.mdx plus a docs.json entry in the Agent Canvas release-notes group, matching the existing v1.10.0–v1.25.0 pattern (Agent Canvas 1.26.0, released October 8, 2026, with Highlights/Fixes/Maintenance and GitHub links).
• openhands/usage/agent-canvas/backends.mdx and openhands/usage/agent-canvas/troubleshooting.mdx for the suspended workspace/membership screen and workspace switching.
• openhands/usage/agent-canvas/first-time-setup.mdx for the Super Admin setup guide and its interaction with the "Getting started" checklist.
• openhands/usage/agent-canvas/managing-automations.mdx (Run Statuses) for the narrowed "Needs review" behavior.
• openhands/usage/agent-canvas/canvas-extensions.mdx for the authenticated backend view helper.
• For the Do-Not-Track telemetry, Docker runtime packages, and cloud sandbox resume items, use Needs maintainer triage. to confirm whether any current page documents them.

Source links

• https://github.com/OpenHands/OpenHands/releases/tag/v1.26.0
• https://github.com/OpenHands/OpenHands/pull/17656
• https://github.com/OpenHands/OpenHands/pull/17864
• https://github.com/OpenHands/OpenHands/pull/17961
• https://github.com/OpenHands/OpenHands/pull/17969
• https://github.com/OpenHands/OpenHands/pull/17988
• https://github.com/OpenHands/OpenHands/pull/18138
• https://github.com/OpenHands/OpenHands/pull/17682
• https://github.com/OpenHands/OpenHands/pull/18128
• https://github.com/OpenHands/OpenHands/pull/18130
• https://github.com/OpenHands/OpenHands/pull/17665
• https://github.com/OpenHands/OpenHands/pull/18149
• https://github.com/OpenHands/OpenHands/pull/18134
• https://github.com/OpenHands/OpenHands/pull/18086
• https://github.com/OpenHands/OpenHands/pull/17474
• https://github.com/OpenHands/OpenHands/pull/17660
• https://github.com/OpenHands/OpenHands/pull/18048

This issue was created by an AI agent (OpenHands) on behalf of the user.