Document Best Practices
Managing documents is important for making your site easy to search, for making internal documents easy to find and link to and for general website maintenance.
On this Page:
- Is a PDF the Right Format?
- Uploading and Linking to Documents
- Naming Documents
- Deleting Documents
- Overwriting Documents
Is a PDF the Right Format?
Before uploading a document, ask yourself if a document is the best format for sharing this information. Consider adding the content to an existing webpage, to a new webpage or sharing it in some other way.
Using HTML Content versus PDFs
Benefits of HTML Content
Whenever possible, web content should be added directly to a page.
Benefits of using an HTML web pages are that you'll have:
- accessible, responsive pages (able to resize for mobile devices)
- content that's easier to update
- content that's easier for search engines to find
- a format that's easier to track user engagement
- a channel that more easily accommodates multimedia, interactive elements
- content that's easier to share on social media
- content that's easier to navigate
When to use HTML
When in doubt, use an HTML web page. More specifically, you should consider an HTML-only web page when:
- content is 1-2 pages or fewer than 800 words
- content needs to be easily readable, scannable and digestible
- content directs users to an online call-to-action
- content will be updated periodically or frequently
- audience is expected to read online
- goal is engagement (reading, clicking) and/or to share across other channels (email, social media, partner sites)
Benefits of PDFs
PDFs can be helpful for specific cases, link when:
- content is primarily for printing
- there is complex formatting, such as charts and forms
When to use PDFs
Here are a few reasons you may want to use PDFs, like when:
- content is 3+ pages or more than 1,000 words
- content needs to be printable and able to distribute as a hard copy
- the audience will likely want to print and distribute the content
- the goal is for audience to download the content
When to use both HTML Content and PDFs
It can be helpful to use both HTML and PDFs when:
- content is 3+ pages or more than 1,000 words
- content includes tables, charts or other elements that may need to be adjusted in the HTML content
- the call-to-action involves a content download
- the audience is expected to want to read the content online but may need a print option
Uploading and Linking to Documents
There are several best practices when it comes to providing access to documents.
- Always upload and publish a document before linking to it. Do not directly link from SharePoint or another online database.
- Always link to the official version of a document 鈥 do not upload a separate version of another office鈥檚 document to your site section.
- When uploading documents, always upload them to the 鈥渄ocuments folder鈥 so that your documents are in one place and you can ensure duplicates are not uploaded.
- When linking to documents in the content management system, all documents must be set to 鈥渙pen in a new window.鈥
- When linking to a document, you will automatically be directed to staging. You want to make sure that you switch to production through the drop-down in the top right corner so that you have access to the full library of images/documents available.
Uploading a Document to Staging vs. Production
The website is set on a dual server 鈥 a staging area and a production area. Staging is what you have access to edit. Production is what you have access to link to but not edit.
When you upload a document, it will upload to staging. You need to publish it in order to have it show up in production. You will want to submit it for approval or publish so that you can link to it.
Uploading a Document Step-by-Step
There are multiple ways to upload a document to the website, but this is our recommendation. It鈥檚 what we do and what we find the easiest.
1. Navigate to your homepage and log in to the CMS
Once you are on your homepage, click the 漏 and log in using your Towson NetID.
2. Go to the 鈥減ages鈥 section of your website
On the top bar, find 鈥渃ontent.鈥 Click the drop-down. From there, select 鈥減ages.鈥
3. Click on your 鈥渄ocuments folder鈥
In your pages section, you will have a documents folder. Open that up.
4. Upload your document
Click 鈥渦pload鈥 in the top right corner. Select add or drag and drop your file. Select the overwrite option if you are overwriting the document. Click 鈥渟tart upload.鈥 Remember that documents cannot have capital letters and must be spaced out by 鈥 (dashes) in order to upload them.
5. Publish your document
Once uploaded, check the box next to your document(s). Then click 鈥減ublish.鈥 You are now able to link your document.
Naming Documents
Always use a generic file name to correctly name your documents.
For example, instead of 鈥渟ummerrequestform-revision11-approved092828.pdf,鈥 name the file something that is understandable and short, such as 鈥渟ummer-request-form.pdf.鈥
File names must be lowercase, contain no spaces or special characters and use a hyphen between words.
Deleting Documents
It is important to remove old and unused documents from the website. Even after removing document links, documents can continue to be found in search results.
To have a document removed from the CMS, submit a service request. Follow these instructions in the request:
- Select "Open a Ticket"
- Select "Web Content & Publishing"
- Select "University Website & Modern Campus CMS"
- Select "Open a Ticket"
- Enter the name of the document and the file path where it is located
Overwriting Documents
Instead of uploading a completely new file when a document is changed, you should overwrite the existing document.
Overwriting documents ensures:
- links to the document remain intact
- existing search engine results will continue to function
- you can avoid deleting old versions of a document from the server. This is another reason to use a generic file name when uploading documents.
For instructions on how to overwrite documents see Overwriting an Existing Document (PDF).