- Last Modified:
- 08 May 2019
- User Level:
Unless you have been granted read/write access rights to the Media Library – your access is "read-only".
The Media Library is the home to the Media Items you will be using in your site(s). Media Items can be:
- documents (e.g., text files, MS Office, PDFs, etc.)
- audio and video
By default, any user can access these files to use them in a Content Item (via a Media Content Element or the HTML Editor), Content Layout or Page Layout (using the Generate T4 Tag feature), but only Administrators or users who have been granted appropriate access can add and modify files in the Media Library. Read access can also be removed for particular Media Categories. Power Users and Administrators also have direct access to the Media Library from most assets.
Media Items in the Media Library use a System Content Type referred to as a Media Content Type. This is the only Content Type associated with the Media Library. The Media Library can be accessed from many parts of the system, including directly from the content if you have a Media or HTML element or via the menu at Content > Media Library.
Using the Media Library
To access the Media Library, go to Content > Media Library. This screen appears:
With a new installation, the list is empty but as you add more items to the Media Library, the list will grow.
Media Library Controls
- Search: To locate Media Items, enter the Media Item name or the keywords associated with it in the Search box and click Search.
- Jump: Each Media Item has a unique ID number associated with it. If you have the ID for the Media Item, enter it into the Jump box and select Jump.
- Bulk actions: Delete or move multiple files to a different Category. You must select two or more items' checkboxes to use the Bulk actions.
- Add Media: Create new media within the currently selected Category.
Categories help you keep stay organized. When you add a new item to the Media Library you can choose to add it to a new or existing Category folder. Categories are arranged in a hierarchical folder structure so you can place Child Categories inside Parent Category folders. It's worth taking time to plan the Categories and Child Categories organization that would work best for your organization.
It is possible to:
- Expand and collapse Categories using the + and - buttons to the left of a parent Category. Categories can expand to full page size.
- Create Category, Edit Category and Delete Category.
Media Items are listed in a table. You can change the number of items that will be listed per page by using the records dropdown options on the top right. To quickly search through the items in the selected Category you can enter text in the Filter input on the top right.
Each Media Item is a row in the table. Columns are as follows:
A thumbnail view of image files will be displayed. For other file types, a document icon is displayed.
|Name||The name of the Media Item. This links to the Edit screen where you can change the Media Item's settings or upload a new file.
The Media Item ID number is also displayed. This number can be used to search for a Media Item via the Jump input.
|Version||When a file is uploaded and saved as a Media Item it has a version number of 1.0. When a new file is uploaded to the Media File input on the Edit screen, the version number increments. A full list of file versions can be viewed in the History tab of the Edit screen.|
A Media Item has a status of Approved when uploaded. When deleted the status is changed to Inactive and it will no longer publish.
To permanently delete a Media Item go to Content > Recycle Content. In the Inactive Content tab, you can use the Filter to search for the Media Item. When it is selected, click on Purge Content.
To revert the status of a Media Item from 'Inactive' to 'Approved' just change any of the Media Item settings in the Edit screen and Save Changes.
|Filename||The name of the file that was uploaded to the Media Library|
|Type||The Media Type that is associated with the Media Item|
|Size||The Media Item's filesize in kilobytes|
When clicked, the Action Menu will expand to show the following options:
Select multiple Media Items to apply the Move and Delete Bulk Actions
Adding a Media Item to your content
To add a Media Item to a Content Item, the Content Type used must include an HTML element:
When creating a Content Item with an HTML element you will see the HTML editor. To add a Media Item select the Insert from Media button:
When an image is selected from the Media Library it will use the image Media Content Layout to output the img HTML element so the image will display on the page. If a document like a PDF or Office doc is selected, the name of the Media Item will be output with a link to the file.
To learn more about setting up Media Types and Media Content Layouts have a look at this video.