Images and PDFs


images and pdfs

In this section, learn how to:

  • Upload images to Aspen's web builder
  • Upload PDFs to Aspen's web builder



When uploading files into Aspen, Aspen is looking at the file name. Even though you can add a title to the file name in Aspen, if you upload a file named "image.png" with a title and picture of 'book' and then you upload a file named "image.png" with a title and picture of 'library', then Aspen is going to overwrite the image of the book and show the image of the library because the file name is the same. When uploading images and files, use unqiue file name strings.


Aspen allows image uploads in two different ways:

  1. Via text editor in web builder pages, placards, system messages, etc.
  2. Direct upload via the Images section of the web builder module


Uploading a New Image

  1. From Aspen Administration, navigate to Web BuilderImages.
  2. Click Add New.
  3. Enter a title for your image.
  4. Click Select an image to upload a Full Size Image. Don't worry about uploading any other sizes; Aspen will automatically generate the other images sizes once a full size image is uploaded.


upload a full size image


  1. Save your changes at the bottom of the screen.
  2. You'll now see that Aspen has generated the other image sizes based on your full size image. Aspen uses these different images according to different screen sizes -- the size of web builder cells also plays a part in this, when applicable -- so that the layout can resize responsively.


many image sizes


If your full size image is smaller than the max pixel size specified for each image size, then the image size will stay the same. Hover over the tooltips for each image size option for more details.



Viewing an Image

  1. From Aspen Administration, navigate to Web BuilderImages.
  2. On this page, you'll be able to view images uploaded either from within the text editors or directly from the Images section. When uploading an image via the text editor, Aspen will use the file name for the image's title. Images uploaded directly will use the image title you've specified (if applicable). 
  3. Sort images using the Sort By dropdown menu. 
  4. Filter images by clicking FiltersAdd Filter. Select a filter ("Title" is likely the most useful here), then click Add Filter. Enter in your desired filter criteria, then click Apply Filters to see the filtered results.


Deleting an Image

  1. From Aspen Administration, navigate to Web BuilderImages.
  2. Click to edit the image you wish to delete.
  3. Click Delete.

Upload your PDFs into Aspen Discovery! These PDFs can be directly linked to or embedded within custom web builder pages.
To get started make sure Web Builder is enabled: Aspen Administration > System Administration > Modules > click into Web Builder > check Enabled? > Save
Next check your permissions by going to Aspen Administration > System Administration > Permissions > select from the dropdown a Role to Edit (typically your Full Admin or Opac Admin) > use the Search For Permission tool above that to search Web Builder > for full permissions select everything that has ALL. For PDFs specifically, you will need: Administer All Web Content. Save and refresh your screen.

Uploading a New PDF

  1. From Aspen Administration, navigate to Web BuilderPDFs.
  2. Click Add New.
  3. Enter a title for your PDF.
  4. Click Select a file to upload a PDF from your device.
  5. Save your changes.


Linking to a PDF

  1. Find your desired PDF in  Web BuilderPDFs, then click to edit.
  2. Click View PDF will take you to a PDF viewer. Copying the URL at the top of the screen will provide a direct link to this viewing page. If linking to this PDF from an external website, copy the full URL at the top of the page. If linking to this PDF from another page within Aspen Discovery, we recommend copying everything after the main catalog URL; this way, even if your main catalog URL changes, the link will still function. In the example below, you could copy: /Files/11/ViewPDF



Additionally, after clicking Edit on a PDF, you can download a copy of the PDF or change the PDF title.


Note: The Full Path and the Thumbnail Full Path are not the URLs you will need for linking to the PDF or to the thumbnail generated for this PDF. They are paths where the files are stored on the server.



Embedding PDFs in Custom Pages

  1. Edit the cell within the custom page where you would like to embed the PDF.
  2. For the Source Type, select PDF. Two new dropdown menus will appear.
  3. Under Source ID, your existing PDFs will display here by title. Select your desired PDF.
  4. Under Display the PDF, select either Embedded in Cell to embed a PDF viewer within the cell, or select Thumbnail Link to embed a single thumbnail image linked to another page with the full PDF viewer.