This page adds detail to The diagram page: what happens when you click Save Diagram, and the messages the diagram page shows while it loads or saves, with what each one means. When Save Diagram can be clicked, and what Cancel does, is described in The diagram page.
| What |
What happens when you click Save Diagram |
| Text you are still typing in a shape |
When you click Save Diagram, the text in the shape is finished and kept, as if you had clicked outside the shape, before the drawing is saved. |
| Name and Description |
Save Diagram saves the diagram’s name and description without spaces at the start and end. A change that only adds or removes such spaces does not count as a change, so on its own it does not make Save Diagram clickable. |
| The drawing |
Save Diagram saves the drawing in an editable form, together with a picture of it that the diagram library uses for the thumbnail and the preview, and that is used when the diagram is inserted in a text field. |
| Pages |
A diagram has one page: Save Diagram keeps only the first page of the drawing. This also applies to a drawing that comes into the drawing editor with several pages, for example by import. No message tells you that the other pages are left out. |
| The Updated date in the diagram library |
Saving a diagram changes its Updated date only when the name or the description has changed; see Diagram library: sorting, dates, paging and narrow windows. |
| Cancel on the diagram page |
Greyed out while a save is running. |
| Time limit for a save |
The diagram page waits up to 20 seconds for the drawing editor to hand over the drawing. If it takes longer, you get an error message and stay on the diagram page, so you can save again. |
| After a successful save |
A message that the diagram was created or updated, and the diagram library is shown again. |
Diagrams already inserted in documents do not change when you save; see Insert a diagram in a document.
| Message |
When it appears |
What to do |
| “Loading draw.io editor…” and “Please wait while we initialize the diagram editor” |
While the drawing editor starts. |
Wait until the drawing editor is shown. |
| “Failed to load diagram” |
The diagram you opened with Edit Diagram could not be loaded. |
Go back to the library and open the diagram again. |
| “Failed to load diagram file. The diagram may not exist or may be corrupted.” |
The drawing of an existing diagram could not be loaded. |
Check in the diagram library that the diagram still exists. If it does, open it again. If the message comes back, contact Antenor; see Get help from Antenor support. |
| “Invalid diagram file format. The file may be corrupted.” |
The stored drawing is in a form the drawing editor cannot read. |
Contact Antenor; see Get help from Antenor support. |
| “This diagram was saved in SVG format and cannot be edited. The image is available for viewing, but you will need to create a new diagram to make changes.” |
The diagram is stored only as an SVG picture, without an editable drawing. |
You can still see and insert it. To change it, create a new diagram. |
| “Error loading diagram:” followed by a technical text |
The drawing could not be handed to the drawing editor. |
Open the diagram again. |
| Message |
When it appears |
What to do |
| “Diagram created successfully” |
A new diagram has been saved. |
Nothing; the library is shown. |
| “Diagram updated successfully” |
An existing diagram has been saved. |
Nothing; the library is shown. |
| “Please enter a diagram name” |
Name is empty. |
Type a name and save again. |
| “Diagram editor not ready. Please wait a moment and try again.” |
The drawing editor, or the drawing of an existing diagram, has not finished loading. |
Wait a moment and save again. |
| “Save operation timed out. XML format is required for editing. Please try again.” |
The drawing editor did not hand over the drawing within 20 seconds. |
Save again. |
| “Diagram export data is missing. Please try saving again.” |
The drawing editor handed over only part of what is saved. |
Save again. |
| “No diagram data to save. Please try again.” |
The drawing editor handed over an empty result. |
Save again. |
| “Invalid diagram format received. Please check console for details and try again.” or “Invalid diagram format. Please try again.” |
The drawing editor handed over the drawing in a form that cannot be saved. |
Save again. If it keeps happening, contact Antenor; see Get help from Antenor support. The browser console that the first message mentions is for Antenor support; you do not need to open it. |
| “Diagram content looks empty. Existing diagram was not overwritten.” |
You saved an existing diagram while its drawing was empty. |
The stored drawing is kept. Check the drawing and save again. |
| “Failed to save diagram files” |
Antenor BMS could not store the drawing. |
Save again. If it keeps happening, contact Antenor; see Get help from Antenor support. |
| “Failed to create diagram” or “Failed to update diagram” |
The save failed for another reason. |
Check the diagram in the library and save again if your change is missing. |
| “Diagram saved. Note: This diagram is in SVG format and cannot be edited later.” or “Diagram updated. Note: This diagram is in SVG format and cannot be edited.” |
The drawing editor handed over only an SVG picture, without an editable drawing. The diagram is saved, but it cannot be opened for editing later. |
To change the drawing later, you will need to create a new diagram. |
diagram, save diagram, error message, diagram not saved, diagram editor, draw.io