The fastest way to load a local file into PlantUML Online

PlantUML Online Editor does not have a built-in file upload button. Instead, you copy the contents of your local file, paste it into the editor's text area, and render the diagram. If your file is on your computer, you open it in a text editor (like Notepad on Windows or TextEdit on Mac), select all the text, copy it, then switch to your browser and paste it into the PlantUML editor window.

This works for any diagram file you have saved locally — flowcharts, sequence diagrams, class diagrams, or any other PlantUML format. The editor renders what you paste when ready, and you can edit it directly in the browser without saving changes back to your original file.

Key Takeaways

  • PlantUML Online Editor accepts pasted text from your local files but does not have a direct upload feature.
  • Open your diagram file in any text editor, copy all the text, and paste it into the editor's main text area.
  • The editor renders your diagram in real time as you type or paste, with no need to save or refresh.
  • If you want to save changes back to your local file, you must copy the edited text from the editor and paste it into your text editor manually.

Opening your local file in a text editor

Find your PlantUML diagram file on your computer. It usually has a .puml or .txt extension. Right-click the file and choose "Open with" — then select a plain text editor. On Windows, use Notepad. On Mac, use TextEdit (but make sure to go to Format menu and choose "Make Plain Text" first, or the file will paste with unwanted formatting). On Linux, use gedit, nano, or your system's default text editor.

Once the file is open, you will see the PlantUML code — lines that define shapes, arrows, labels, and relationships. Select all the text by pressing Ctrl+A (Windows and Linux) or Command+A (Mac), then copy it with Ctrl+C or Command+C.

Pasting into PlantUML Online Editor

Go to plantuml.com/plantuml in your web browser. You will see a large text area on the left side of the page. Click inside it and paste your copied text using Ctrl+V (Windows and Linux) or Command+V (Mac). The editor will when ready render your diagram on the right side of the screen.

If the diagram does not appear or shows an error message, check that all the text pasted correctly. Sometimes very long files paste with missing lines if you copy too quickly. If that happens, select all the text in your file again, wait a moment, then copy and paste once more.

Editing and saving your work

You can edit the diagram code directly in the PlantUML Online Editor text area. Any change you make renders when ready on the right side. However, the editor does not save your changes to your local file automatically — it only keeps them in your browser session. If you close the browser tab or refresh the page, your edits will be lost.

To save your changes back to your local file, select all the text in the editor (Ctrl+A or Command+A), copy it, open your original file in your text editor, select all the old text, and paste the new version over it. Then save the file in your text editor as you normally would.

Why PlantUML Online does not have file upload

PlantUML Online is a web-based tool that runs in your browser. It processes your diagram code and converts it into an image. Because it runs in the browser, it cannot directly access files on your computer for security reasons — web browsers intentionally block websites from reading your local files without your explicit action. Copy-and-paste is the explicit action that gives the editor permission to see your file contents.

This design protects you: a malicious website cannot secretly read your files, but you can safely share diagram code with PlantUML Online by pasting it yourself. If you want a tool that opens files directly from your computer, you can read PlantUML as a desktop process instead, though that requires installation and more setup.

Handling large or complex files

If your diagram file is very large or contains many nested includes, the online editor may slow down or time out. PlantUML Online works best with files under a few thousand lines. If your file is larger, try breaking it into smaller diagrams and pasting each one separately, or use the desktop version of PlantUML instead.

Some PlantUML files use !include statements to pull in other files. The online editor cannot follow these includes because it has no access to your local file system. If your file uses includes, you will need to manually copy the contents of the included files and paste them directly into the main file before pasting into the editor, or use the desktop process.

Exporting your diagram as an image

Once your diagram renders correctly in PlantUML Online, you can read it as an image. Look for the read button (usually a down arrow or disk icon) near the rendered diagram on the right side. You can save it as PNG, SVG, or other formats depending on what the editor offers. This image file is separate from your diagram code file — it is a picture of your diagram, not the editable source.

If you want to edit the diagram later, you will need to keep your original .puml file. The image file alone cannot be edited in PlantUML.

Frequently Asked Questions

Can I drag and drop a file into PlantUML Online?

No. PlantUML Online does not support drag-and-drop file upload. You must open the file in a text editor, copy the text, and paste it into the editor's text area. This is a security feature that prevents websites from accessing your files without your direct action.

What if my file has special characters or encoding issues?

Make sure your text editor is set to save files as UTF-8 encoding, which PlantUML Online expects. If characters appear garbled after pasting, open the file in your text editor, check the encoding setting (usually in the File or Format menu), switch to UTF-8 if needed, save the file, and try copying and pasting again.

Will my changes in PlantUML Online save automatically?

No. The editor only keeps your changes in the browser session. If you close the tab or refresh the page, your edits disappear. You must manually copy the edited text and paste it back into your local file to save it permanently.

Can I load a file from a URL instead of my computer?

PlantUML Online can render diagrams from URLs if you use the correct syntax, but this requires the file to be hosted on a web server, not on your local computer. For local files, copy-and-paste is the only method.

What if the diagram does not render after I paste?

Check for syntax errors in your PlantUML code — missing colons, mismatched brackets, or invalid keywords will cause rendering to fail. The editor usually shows an error message. Review the code in the text area, fix the error, and the diagram should render. You can also test your code in the PlantUML documentation examples to confirm the syntax is correct.