Updating an existing document

Update documents, rather than unpublishing and replacing them with a new version.


When it comes time to update or replace an outdated document, it's important to do so correctly for a number of reasons. Updating a document correctly means the new version keeps all of the valuable search rankings that the older version had. This way, people searching for the old version will quickly and easily find the new version.

Updating the existing document, rather than unpublishing it and creating a new document, also prevents the old document from appearing in search results, which can cause confusion and frustration to users.

Finally, updating documents using the following steps helps prevent broken links where you've linked to the older version. It's still a good idea to check which pages are linking to your document before replacing your document.

How to update your document

To update or replace an existing document with a new file in edit.mass.gov, follow these steps:

  1. Navigate to the “All Documents” tab under the “Content” menu

  2. Use the search filters to find your document

  3. Click “(edit)” next to the title of the media entity that contains your file (What's a media entity?)

  4. In the select the file field, click “remove”

  1. Click the “Choose File” button in the select the file field and select your document

  2. Scroll to the bottom of the page and make sure the Change to: state is set to "Published."

  3. Click “Save”

Updates made to a media entity will be reflected anywhere you’ve linked to that entity.

Was this article helpful?

Tell us what you think button