Library Symbol update declined in Sketch: no documented way to roll an instance back to a prior Library version
0 reputation · 31 Oct 2020, 00:28 UTC
0 reputation · 31 Oct 2020, 00:28 UTC
In Sketch (recent versions, Workspace documents), Symbols from a shared Library can be updated in place, and documents referencing them show an update prompt rather than applying changes silently. Overrides on text, images, and nested Symbols are preserved per instance.
The unresolved case: once a Library update is accepted and the document is saved, there appears to be no documented per-instance mechanism to return a single Symbol instance to the earlier Library version. Undo is session-scoped and lost when the document closes, and detaching the instance only converts it to ordinary layers. Workspace version history can restore an earlier whole-document state, but that reverts everything, not just the one Symbol.
Assuming a current Sketch release and a Workspace-saved document:
There is no built‑in, per‑instance way to roll a Symbol back to a previous Library version after you have accepted the update and saved the document. Sketch treats the Library reference as a single version pointer for the whole document; once that pointer is moved forward, the only supported ways to change it affect the entire document (e.g., Workspace version history) or destroy the instance (detach).
Sketch stores only a single Library version identifier per document (or per Library reference). There is no per‑instance metadata that tracks which version of a Symbol was originally used, so after the version identifier is updated there is no internal record to which an individual instance could revert.
Symbol ▸ Replace Symbol….Replace. Overrides (text, images, nested Symbols) are preserved as far as they match the older Symbol’s structure.Symbol ▸ Detach from Symbol) to edit it freely.When the Library file is saved with an older version number, Sketch compares the stored version in each document. If the document’s reference is newer than the Library’s current version, Sketch will show an update prompt again, offering to downgrade the Symbol to the Library’s current state. Accepting that prompt will bring all instances of that Symbol back in line with the older Library. There is no known case where instances become “stuck” on the newer state; they will always respond to the version comparison.
Declining the update leaves the document pointing at the older Library version (the one it originally referenced). The Symbol instances continue to render using that older version until you either accept the update later or manually replace the Symbol. This behavior is documented in Sketch’s release notes for Library updates: the prompt is non‑blocking and the choice is persisted per document.
To confirm that the steps above apply to your exact setup, please let me know which Sketch version you are using (e.g., 91, 92, or later). If you are on a version prior to the introduction of Workspace‑based Library handling, the replacement workflow may differ slightly.
Use comments to ask for clarification. Post a solution as an answer.
No question comments on this page.