The PDF document format is used to preserve original formatting that cannot be easily recreated on a web page. PDFs are often a great option for downloadable forms or documents/flyers that you expect your visitors will download and/or print. If your primary goal is to simply publish content, you should do so as a web page in WordPress and not as an uploaded PDF.
Key Concepts
- Publishing content as a standard web page is more accessible than uploading and linking to a PDF file; it is also more easily discoverable by both visitors and search engines.
- Publishing content as a standard web page allows you to edit content quickly and easily; replacing a PDF with an edited/updated version requires more time and resources.
- You cannot redirect links to PDFs in BU WordPress; linking directly to PDF files can be problematic (see linking best practices below).
- All BU websites must comply with our Minimum Web Accessibility Standards. These standards ensure that all users, including those with disabilities, can access the content on your site. This includes ensuring PDFs are tagged for accessibility.
Using & Linking to PDFs
When To Use a PDF
- PDFs are an excellent option for downloadable forms. Visitors can use Acrobat to fill out a downloadable form without a need to fill out a paper form. (Always ensure your data collection and storage workflows follow the University’s Data Protection Standards.)
- Event flyers are a great thing to share via PDF. Provide a downloadable PDF in addition to publishing the event information on a standard web page. Supporters can download, print, and post your flyer to help promote your event.
- Lengthy documents that are frequently printed for offline reference.
- Content that needs to be shared digitally offline.
When Not To Use a PDF
- You have a document from another application (like Word) that you saved as a PDF and it’s just easier to post it.
- You like the design/layout of the PDF better than how it looks as a web page.
- The PDF looks fine when you look at it on your computer so it will be fine for everyone else.
- You don’t know how to use WordPress to publish this content.
Maintaining accessible content is University policy; that fact is more important than how easy something is to do or if it looks exactly like you want it to. Standard web page content will always be more accessible and discoverable than content in a PDF.
If publishing your content as a PDF does not provide added value (such as ease of printing or filling out a long form), you should most likely publish it as a standard web page.
How to Link to a PDF in BU WordPress
- Place your cursor where you want the link to appear in your WordPress page.
- Click the Add Media button to open the Media Library.
- Choose the PDF from the Media Library; or upload your tagged PDF at this time.
- In the Title field, give the PDF a meaningful title and include “(PDF)” in the linked text.
- Under Link To, select Attachment Page (recommended) or Media File (not recommended – see best practices) for direct links.
- Click Insert into Post to add the link.
Always indicate in your link text that you are linking to a PDF; for example use link text such as this: Download the event flyer (PDF).
Best Practices when Linking to PDFs
- Avoid linking directly to the PDF media file. Linking directly to a media file bypasses the WordPress page URL and therefore becomes a link that cannot be redirected. That means that if you share the wrong URL — or want to redirect folks that have an old URL — you simply cannot do that if you have linked directly to the PDF media file.
- Publish links to your PDFs on regular web pages, and ensure your links to the PDFs are prominent and easily discoverable, and then share the link to the web page(s) instead of linking directly to the PDF media file(s).
- If you use PDFs for policies, resources, and other types of information that is frequently updated, it is best to create a landing page where you link to your PDFs. Always share the link to the landing page, rather than sharing links to the individual PDFs. It’s easy to change the link on the landing page; it’s not possible to redirect a link to a PDF file.
Creating Tagged PDFs using Microsoft Word
Microsoft Word is a great option for creating tagged PDFs. Most BU users have access to Word, making it an accessible option for creating tagged PDFs.
- Use built-in heading styles (Heading 1, Heading 2, etc.).
- Ensure all images have relevant descriptions in the alternative text (alt text), and tables are labeled clearly with column and row headers.
- Go to File > Save As and select PDF.
- In the save options, choose Best for electronic distribution and accessibility.
Creating Tagged PDFs using Adobe Acrobat
Adobe Acrobat Pro is the most accurate tool for creating tagged PDFs and checking accessibility. If you have access to Adobe Creative Cloud, you may already have Acrobat Pro. If not, check eligibility for a license through
Adobe Creative Cloud at BU.
- Open your PDF in Adobe Acrobat Pro.
- Go to the Accessibility tools panel.
- Select Autotag Document to add tags automatically.
- Run the Accessibility Checker to ensure compliance with accessibility standards and follow the recommendations in the tool to fix any issues.
For more information, see the Adobe guide: Creating Accessible PDFs.
Creating Tagged PDFs using Google Docs
If you don’t have Microsoft Word, Google Docs can be used to create tagged PDFs:
- Apply proper heading styles and provide alt text for all images.
- Go to File > Download > PDF Document (.pdf).
Google Docs creates an accessible PDF, but always check the exported file for accessibility.
Frequently Asked Questions
What are tagged PDFs?
Tagged PDFs contain additional markup that defines the reading order and logical content structure of the document, allowing screen readers and assistive technologies to read and navigate the content properly. Without tags, a PDF may not be accessible to users with disabilities.
I have a paper document I need to post as a PDF. How do I best do this?
- Reference the IS&T guide on Creating PDFs from Paper Documents.
- Use a copier or scanner with Optical Character Recognition (OCR).
- Always review text after scanning — OCR accuracy can vary.
- Scan at 300 DPI for the best results.
- Use your scanning software to Save As … and select PDF.
- If your scanning software did not produce a tagged document, use Adobe Acrobat Pro to tag the document for accessibility.
- If those steps have not worked, consider recreating the content as a web page or a properly tagged document.
Can I replace a PDF media file without changing the link
If your PDF file has been uploaded through the WordPress dashboard, you can use Enable Media Replace to simply replace the existing PDF file with a file using the same file name. Follow our documentation on how to replace existing files in the Media Library.
If you do not see the menu option to “Replace Media” in your Media Library, contact IS&T to request the Enable Media Replace plugin be turned on for your WordPress site.
My PDF upload in BU WordPress failed. How can I fix it?
When a PDF is uploaded to websites in BU WordPress, an automated check is run on the document to ensure the presence of tags for accessibility. Untagged PDFs are inaccessible to screen readers, so PDFs without accessibility tagged are not permitted to be uploaded. If your upload failed, your document is likely missing these tags. Use the resources above to create a tagged document for a successful upload.
My authoring software has Save As, Export, and Print As PDF options. Which should I use?
Authoring software can have several options to create PDFs. The following guidelines apply generally.
- SAVE AS PDF – The “Save As…” menu option in some software programs allow you to save as a PDF. “Save as” generally produces the best document for accessibility compliance.
- EXPORT – Some software programs have an “Export” or “Export as PDF” option; this is generally the same as “Save As” but may require additional user input before saving the document.
- Avoid “PRINT AS PDF” – the “Print as PDF” option creates a PDF file specifically for printing. Much of the accessibility information may not be included in a PDF generated solely for print.
PDF Accessibility Deep Dive
Key points for creating accessible PDFs
Keep accessibility in mind from the outset. Many techniques to author accessible PDFs require that you use special editing tools in your authoring software. Adobe Acrobat Pro, Microsoft Office applications, and many other authoring tools support PDF accessibility.
Learn how to use the tools in the source software so when you export your file as PDF, you will have the accessibility requirements in place. For example, Microsoft Word is a very common software tool used to create PDFs.
- Headings/heading structure – Tag your headings specifically as headings like HTML – H1 as the main heading, stepping down to H2, etc., structuring your document hierarchy.
- Alternative text for images – Important images need informative Alt attributes describing the image so it is fully understandable to non-visual users. Unimportant images and graphics should have empty Alt attributes so they can be skipped.
- Table structure – As with web pages, tables should only be used for tabular data and should not be used for layout. Table property settings in the source software can be set up to produce PDFs that mark table elements such as rows, headers, and spans appropriately for assistive technologies.
- Descriptive links – As with web pages, do not use “here” or “click here” or other generic words for link text. Make your link text descriptive of the content you are linking to, using actionable and relevant keywords.
- Lists – Use lists when you have an actual list. Several lines of text with line-breaks at the end may look like a list, but the list should be tagged appropriately for assistive technologies to read the list and understand there is relationship in the list items.
- Legible text size – An appropriately tagged PDF uses the document’s logical structure to allow page content defined into structural types. Text content should be a legible size, and text size should be adjustable in a way that the document reflows to accommodate the text without losing any content.
- Good contrast – Foreground and background images, texts, and colors must have sufficient contrast to be accessible to some users with visual impairments. Learn how to test for color contrast and use appropriate color choices. Note also that text size is variable, so small text on a background color may have different contrast requirements than a large text with the same background color.
- No color reliance – Do not rely solely on color to convey information. Color blindness is a common visual impairment.
- Document title – Meta data in your document should be used for discoverability and search engine optimization. Use a document title (required) and optionally use authoring tools to define author, keywords, and other meta data just as you would with a web page. Also note that when viewed in a browser, the PDF’s Document Title appears in the browser tab. Use a title that will still make sense if the file is updated—avoid including dates or version-specific info.
PDF Techniques from WCAG (Web Content Accessibility Guidelines)
The topics linked below contain detailed instructions for using authoring software to achieve accessibility compliance. The topics frequently include specific instructions with screenshots from Acrobat and Office software packages.
Additional Resources