---
title: "DF8101: Cannot Change Dock Id"
description: "Cannot change the id of dock \"{id}\" to \"{attempted}\". Dock ids are immutable once registered"
canonical_url: "https://devfra.me/errors/df8101"
---
# DF8101: Cannot Change Dock Id

> Cannot change the id of dock "\{id}" to "\{attempted}". Dock ids are immutable once registered

## Message

> Cannot change the id of dock "`{id}`" to "`{attempted}`". Dock ids are immutable once registered

## Cause

The `update` handle returned by `ctx.docks.register(view)` received a patch whose `id` differs from the original. Dock ids are immutable post-registration: they key the dock list and any shared-state references.

## Fix

- Drop `id` from your patch; only pass the fields you actually want to mutate.
- To replace one dock with a different one: call `ctx.docks.register(newView)` (or `register(newView, true)` to overwrite an existing id).

## Source

- [`packages/hub/src/node/host-docks.ts`](https://github.com/devframes/devframe/blob/main/packages/hub/src/node/host-docks.ts): `DevframeDocksHost.register()` returns an `update` callable that throws this when the patch carries a different `id`.


## Sitemap

See the full [sitemap](https://devfra.me/sitemap.md) for all pages.