• Home
  • Quick Start
  • Get Started
  • Infrastructure
  • General Web Instruction
  • Skip to primary navigation
  • Skip to main content
  • Skip to primary sidebar
UT Shield
College of Fine Arts Drupal Instructions
  • Home
  • Quick Start
    • Editor Access, Workflow, Approvals & Roles
    • FAQs and Recommended Workflows
  • Get Started
    • The Dashboard
    • Content Types and Layout
      • Categories, Taxonomy and Terms
      • Landing Pages
      • Layout Builder Sections & Blocks
        • Listing Blocks
        • Reusable Blocks
        • Main Navigation Block
        • Quick Links Block
        • Featured Content Blocks
        • Ambient Video Block
      • Announcement Banner
      • Events
        • University Calendar Instructions
        • Pre-Filtered Link
    • Create, Publish, Edit, Unpublish, Delete, Archive
      • Content States: Published, Unpublished & Draft
      • Create Content
      • Edit Existing Content
      • Publishing Content
      • Delete, Unpublish, Archive
      • Revisions
      • Clone
    • Menus, Paths & Links
      • Editing Menus
      • URL Path Address
      • Create a Link
        • Linking to Another Spot on the Page
        • Pre-Filtered Link
        • Non-Visible Link Context and Visually Hidden
      • Secondary Menu
      • Duplicate Menu Label, URL or Title Issues
    • Rich Text Editor
      • Create a Link
        • Linking to Another Spot on the Page
        • Pre-Filtered Link
        • Non-Visible Link Context and Visually Hidden
      • Insert an Image
        • Left & Right Image Alignment
      • Insert a Document
      • Multimedia and Embeddable Content
      • Adding Hide/Reveal Elements
      • Tabular Data in Tables
      • Responsive Word Wrapping & Hyphenation
      • HTML Source
        • Hide on Desktop or Hide on Mobile
    • Media (Images, Documents & Videos) Management
      • Insert an Image
      • Insert a Document
      • Multimedia and Embeddable Content
  • Infrastructure
    • Site Search
    • Caching
    • Community Factors
    • Database vs. Code
    • Test Site
    • Release Cycles
  • General Web Instruction

Insert a Document

Last Updated February 2025

On this page

  • Best Practices for Documents in Drupal
  • Add a Document to a Body Field
  • Adjust the Caption, Image Size or Alignment

 Best Practices for Documents in Drupal

Please be aware of the following:

  • Be sure your file adheres to accessibility requirements,
  • upload only one version of the file,
  • use a unique well formatted file name and
  • pre-optimize and compress the file as much as possible! You can upload a 8MB file but we recommend that you keep your files as small as possible. An 8MB file will cause issues for some visitors on some devices. If a larger file or different file type is required or if you have any difficulty with these steps, please contact the COFA Web team.

For documents: if inserting as a file it will show the file name and extension and automatically include the file size. If you want to customize the link text, first type the text you want and then follow the instructions for creating a link. You will need to type the file size in parentheses after the link.

Inserting Documents

Add a Document to a Body Field

The easiest way is to upload the file to the Media Library then insert the document into the page using the Link button. Just like any other link:

  1. Type the text that you want to be the link
  2. Select the text
  3. Click the link button Link and Unlink buttons
  4. Begin typing the name of the PDF in the auto complete field.
  5. Click OK
  6. Type the file size in parenthesis after the link.
  7. Add the required link to Adobe Acrobat Reader.

When using this method, it will only show the file name. If you want the PDF icon to display, you will need to manually insert the image.

How to Display Documents on a Page

Following is an example of what it should look like on your page:

Download my document (245 KB).
You may need to install Acrobat Reader to access this document.

Primary Sidebar

Open Office / Co-Working Sessions

Second Monday of the month:
11 a.m. – 12:30 p.m.

Fourth Thursday of the month:
2 p.m. – 3:30 p.m.

Email us for the Zoom link.

College of Fine Arts Web Instruction
Subscribe to our email list to receive periodic tips and resources for generating great digital content

Contact Us

The COFA Web team can be reached by emailing us at cofawebmaster@austin.utexas.edu

UT Home | Emergency Information | Site Policies | Web Accessibility | Web Privacy | Adobe Reader

© The University of Texas at Austin 2025