# Repair diagram tabs

Multi-tab diagram files embedded several times on one page, where every resulting reference shows the first tab instead of the tab the author chose. It also replaces machine-generated titles that leaked onto references from an earlier bug.

Find it under Repair, then the "Repair diagram tabs" card. Works from a log or from a pasted or searched list of page IDs..

---

## What it changes

Sets each reference's tab and, where the title was machine-generated, replaces it with the diagram's real title. Writes a new page version labelled as a tab repair.

---

## What to know before running it

A three-step flow: a read-only check of the live pages, then a read-only analysis that walks page history back to the version just before the migration, then the write. It cannot recover tabs at all if the page history no longer holds the migration version, or if that was the very first version. A tab that no longer exists in the current file is left on the first tab, and an embed that never specified a tab is correctly left alone. References are matched to their original embeds positionally by diagram name, so if two different diagrams on a page share a name or the page was heavily restructured after migration, a reference can be given the wrong tab. Its automatic detection cannot see the single-embed case: one embed of a multi-tab file that pointed at tab 2 shows no symptom and is passed as clean, so it must be added by page ID to be fixed.

ℹ️

**Every write is a new page version** with its own version message, so the repair itself is visible in page history and can be undone from there.

---

## A few things that catch people out

* Bulk operation stays locked until you have fixed and checked one page by hand.
* It only looks at the pages you hand it. It never sweeps the site.
* Cancel stops the queue between pages; anything already in flight still writes.

---

## Related

[Repair diagram versionsMigrated draw.io diagrams that display their oldest content instead of their newest.](https://help.gocapable.com/migration/repair-diagram-versions.html)

[Repair diagram layoutNot a bug fix — a bulk settings change. Switches migrated draw.io diagrams between the cla](https://help.gocapable.com/migration/repair-diagram-layout.html)

[Before you repair anythingThe rules all four share.](https://help.gocapable.com/migration/before-you-repair-anything.html)

---

_Fix forward. Nothing is deleted._