---
title: "Upload a New Version of a File"
lang: en
canonical_url: https://www.peony.ink/docs/getting-started/upload-a-new-version
description: "Replace a file in a Peony data room with an updated version while keeping its place and its link — step by step, plus how to open earlier versions."
---
When a document changes mid-deal — a revised model, a signed version, a corrected deck — replace it with **Upload new version** instead of deleting and re-uploading. The file keeps its place in the room and its link, and earlier versions stay available to you.
## Steps
1. Open the data room and **click the file** to open it.
2. Next to the file name at the top, click **Upload new version**. A menu opens, listing the current versions (**v1**, **v2**…).
3. Click **Upload new version** at the bottom of that menu and pick the updated file from your computer.
4. Wait a few seconds. The new version goes through a quick security scan (you'll see _Security scanning_ briefly), then it appears in the viewer.
Visitors who open the file from now on see the new version, at the same link. To let them switch to earlier versions, see [Let Visitors See Earlier Versions](#let-visitors-see-earlier-versions).
## What Changes and What Doesn't
| | After uploading a new version |
| ------------------------------- | ---------------------------------------------------------------------------------- |
| Position in the room and folder | Unchanged |
| The file's link | Unchanged |
| File name shown in the room | Takes the **new file's name** — rename it afterwards if you want the old name back |
| Earlier versions | Kept, listed in the version menu |
To rename, open the file's **…** menu in the room and choose **Rename**.
## Open an Earlier Version
Click **Upload new version** next to the file name. The menu lists every version with its upload date. Click one (for example **v1**) to open it.
Nothing is lost when you upload a new version: every earlier version stays in this menu, and you can go back to any of them with a single click. That makes it easy to keep track of how a document changed over the course of a deal.
## Let Visitors See Earlier Versions
Turn on **Show version history** in the **Permissions** section of a file or folder link's settings Business+. Visitors then get a version menu in the viewer and can open earlier versions. With it off, they don't see that menu. On **Free** the setting shows an upgrade badge.
## Upload New Version vs Delete and Re-upload
Deleting a file and uploading a fresh copy creates a **new file**: it gets a new link, and any per-file permissions you set on the old one have to be set again. Upload new version avoids both.
## Common Questions
#### How do I replace a file without breaking the link I already sent?
Open the file, click **Upload new version** next to its name, choose **Upload new version** in the menu, and pick the updated file. It stays in the same place with the same link.
#### Can I still see the old version?
Yes. Click **Upload new version** next to the file name: the menu lists every version (v1, v2…) with its date. Click one to open it.
#### Can the new version be a different file type?
Upload the same type where you can (PDF over PDF, XLSX over XLSX). If the format changes, check the file previews correctly afterwards.
## Related
- [Upload, move & organize files](https://www.peony.ink/docs/getting-started/upload-and-organize-files)
- [Excel & spreadsheets](https://www.peony.ink/docs/file-types/excel-and-spreadsheets)
- [Duplicate a data room](https://www.peony.ink/docs/getting-started/duplicate-a-data-room)
---
_Markdown version of [https://www.peony.ink/docs/getting-started/upload-a-new-version](https://www.peony.ink/docs/getting-started/upload-a-new-version.md) for AI agents and LLMs; canonical HTML: https://www.peony.ink/docs/getting-started/upload-a-new-version. Every page on peony.ink is available as markdown — append `.md` to the URL or request it with `Accept: text/markdown`. More: [llms.txt](https://www.peony.ink/llms.txt)._