A range of document files, such as Text files, Microsoft Word and PowerPoint documents as well as Zipped (compressed) files can be uploaded in the CMS. This can then be added on a page for website visitors' use.
Below is a guide to uploading a document file to the CMS media library and guidelines on adding the file to a page for site visitors to access.
On this page
- Before you start
- How to upload a document file
- Find an existing file
- Replace an existing file
- Unpublish a file
- Add a file to a page
Before you start
Consider if you can convert your file into a web page instead.
By default resource web pages should be created instead of downloadable documents. Resource web pages have a print-page function and, if necessary, can also include documents as attachments. Find out how to create a single or multi-page resource. Forms can be created as webforms.
If you are uploading a document file it must comply with the document naming and governance guidelines.
How to upload a document file
To upload a new document:
- Go to Content > Media > Add media > File. The Add File screen will open
- Add the Title for your file. The title should be the same as the document name but without the hyphens. For example, if your file is ‘nsw-statutory-declaration-form.pdf’ then your title would be ‘NSW statutory declaration form’. Capital letters can be used in the title. The title will be shown when a user hovers over the link text
- In the Preview section you can add an image for your file by clicking the Add media button.This field is not mandatory and most files will not need to use this field. Only if your file will appear in a component or page that shows images should you add an image to your file
- In the File section click Choose file to upload your document file. Make sure your document has a descriptive file name with hyphens between words, for example 'nsw-statutory-declaration.pdf'. Find out more about document naming and governance guidelines
- The Licence field can stay at the default option of None or you can select another licence option.
- In the Agency and Editorial group fields start typing and select from the drop-down list
- In the Subject matter experts field you can only select a person that has a user profile created in this CMS. This field is optional
- The Published box is ticked by default. A document will need to be published before it is linked to a web page. A published document is live and can be found by search engines, like Google or from the file's URL
- Ticking the No index checkbox prevents search engines from indexing this file, even if it is published. Although users with a direct link will still be able to find and see the file. This box can only be ticked when a file is being created. After you click the Save button you cannot tick this box later
- The Revision information field is optional if you want to add editor’s notes to your file about the changes you have made
- The URL alias field is optional if you want to create a shorter URL. However, it is recommended that you link customers to the web page that your document is on, rather than directly linking to the file URL
- Authoring information should be left unchanged
- Click the Save button
Find an existing file
To find an existing file, you will need to:
- Find your article by going to the megamenu and selecting Content > Media
- Find media in the CMS
- Use the search fields to find your document and click the Filter button
- To edit the file either:
- click the hyperlinked file name, or
- click the Edit button in the far right column. This will take you to the Edit file screen
Replace an existing file
From the Edit file screen you can replace the file with a new version by:
- Scrolling to the heading Replace file and clicking the Choose file button. You can only replace the file with the same type of file. For example a PDF tcan be replaced with another PDF, not a Word file
- Untick the Overwrite original file checkbox
- Scroll to the bottom of the page and click Save.
Unpublish a file
From the Edit file screen:
- Scroll down to the Published checkbox and untick it.
- Scroll down and click Save. Your document will still exist in the CMS but only editors can see it.
Add a file to a page
There are 3 ways you can link a file to a web page. You can:
- Create a Resource page and add the file.
- Hyperlink text in a Block / WYSIWYG from a standard page, landing page or news article. To hyperlink text, follow the instructions to add links to your content – for media files. You can choose to style your hyperlink as a button.
- Create a component that can link to media files such as the links list or cards.
Need any more help?
If you have any questions, or require assistance with anything mentioned on this article, submit a request via the webform.