Using your Media Library

You have two methods available to you to add new media to your site:

  1. Through the Media Library dashboard (described below), or
  2. Through the WYSIWYG or specific attachment buttons for media (or see each individual block for instructions).

Media Library Dashboard

  1. Navigate to Shortcuts » Media or Shortcuts » All Content » Media tab.
  2. You will be provided a Media Dashboard similar to this screenshot:Screenshot of the media library dashboard
    • Dashboard layout - you can view your media in either a Table (default) or Grid layout. Table will display your media content in rows, while the Grid (as shown above), will show content cards.
    • + Add media - one method for adding new pieces of media is to do so through your dashboard using this button. 
    • Search/Filter - as you increase the size of your library you'll find the search/filter options integral to quickly locate the content you want to use. When you have set your options, click the Apply filters button to narrow your list.
    • Actions menu - lets you Publish, Save, Delete, and Unpublish one or more pieces of media. Click the Apply button to affect the selected items you designate by checking the box in a piece of media's upper left corner (grid view) or to the left of the listing (table view).


Add Media via the Media Library

  1. Click the + Add media button.
  2. Select the type of media you want to upload and add its information:
    • Audio
      Handles audio media files.
      Provide: Name, uploaded File, Description (optional), Category (optional). Restricted to these file types: mp3 wav aac
    • Document
      Handles documents and zip files that can be attached to a content type.
      Provide: Name, uploaded File, Description (optional), Category (optional). Restricted to these file types: txt zip xls xlsx doc docx pdf ppt pptx
    • Image
      Image media entity type.
      Provide: Name, uploaded File, Alternative text, Description (optional), Category (optional). Restricted to these file types: png gif jpg jpeg
      If you add a caption to your image in Media Library, then later add that image to a page or block via the WYSIWYG Insert Image icon and check the Caption checkbox, the original caption will display. You can also edit the caption in the WYSIWYG if you need to make an adjustment. Caption changes made while in a page or block will NOT change the original caption added in the Media Library.
    • SVG
      Handles SVG image files.
      Provide: Name, uploaded File, Alternative text, Category (optional). Restricted to this file type: svg
    • Video
      External (Remote) Video media entity type for handling videos from sources like YouTube and Vimeo.
      Provide: Name, Remove video URL, Description (optional), Category (optional). Restricted to these services: YouTube, Vimeo
  3. Once the information in step 2 is entered, scroll to the bottom of the page and click Save to finish.


Modify existing media in your Library

Once your media is in the Media Library you are able to make modifications.

An entry in the Media Library with its modification options highlighted.

Grid view of a piece of media with its modification options highlighted.

  • Checkbox - Use in conjunction with the Actions menu to Delete, Publish, Unpublish, or Save.
  • Pen icon/Edit - Gives you access to the information you originally provided when you add your piece of media.
  • X/Delete - Delete your media from your site. Please note special steps are required in order to delete media permanently. This deletion step deletes it from your site, but if it's important that the file never be available again (for legal, safety, or reasons related to sensitive information), the SiteFarm team will help you by clearing the file from related services that cache your files. In the event of downtime on our Acquia platform, our caching services—like Fastly—will continue to serve pages so your visitors will never know there's a problem, but this means it also holds on to files you may want removed. Site Managers should review our documentation on Fancy File Delete for the steps necessary to permanently delete a file. 


Replacing in-use media

Replacement Gotcha

Often, users will want to replace an existing file with a new file using the same name and URL. In Drupal's current design, this isn't possible as it holds on to files for use in pages' Revisions tab. Uploading a new version of the file to replace the existing one, will result in a file with a number appended to the end of the file name, which will also change the resulting URL. Example of a replacement file:

Solutions include having a Site Manager go through the steps with the Fancy File Delete process (somewhat involved) or provide an entirely new file name.

Note: we are actively reviewing a module to better handle media replacement.

One of the previous difficulties of Drupal's file system was its inability to smoothly handle the replacement of existing files and images, and its relationship to the Revision system. The new Media Library will allow you to easily replace and/or update existing files already on your site. 

  1. Navigate to Shortcuts » All Content » Media tab.
  2. Locate the specific piece of media and edit using its Edit button or the Pen icon.
  3. Change instructions:
    • Audio, Documents, Images, SVG - click the Remove button, then upload the new file
    • Video - change the URL link
  4. Adjust any other details as necessary, then scroll to the bottom and click Save to finish.
  5. Review any associated pages using the media content to see if it updated.



Possible future development

Because of the challenges involved in the initial integration of Media Library into SiteFarm, we have several issues—called user stories—in our backlog for future consideration and possible development. As you use the new system you may experience one or more of these issues as these features weren't included in the out-of-the-box Media Library offerings from Drupal, but we want to let you know we're aware of them:

  • Images can only be uploaded one at a time instead of in a bulk upload.
  • You might have no idea what caption or description is associated with a piece of media unless you use its Edit button. We'll be considering adding a new column in the main Library dashboard for a quick view of any text associated with a piece of media.
  • If you try to embed a link to a file (PDF, Word doc, etc.) in the flow of body text, it formats the link in a weird way out of the flow of the regular text. For now, consider using the regular document attachment section at the bottom of your pages so it can utilize the Media Library. Make reference to that file from the body text (Example: "See the bottom of this page for the attached documents".) A fuller explanation of the pros and cons of embedding from your Media Library versus your paperclip/Files section can be found in our Upload and Embed Files documentation.

As you work with the new Media Library, we encourage you to consider submitting a feature request via our system and/or up-voting a feature someone else has submitted on these topics if any are of particular urgency to you and your department to help you work more efficiently. If you're not a site manager in your site, please notify a person who holds that role and ask them to submit or vote on the feature request of interest.