Store images and business documents centrally for convenient use on your pages.
Last reviewed: April 17, 2024
Unlike files that are uploaded individually and embedded directly into a page, digital assets are stored centrally in the Assets part of the UBCMS (sometimes called the 'DAM'). Each site has its own folder in Assets, where they can be easily shared onto multiple pages (or sites), and are much easier to curate.
Unlike an asset that is uploaded and embedded directly into a page, Assets are just 'referenced' by the page, linked or displayed as needed, but these assets are actually managed centrally in Assets.
Once you have uploaded files into Assets, you can find them in the Side Panel's Assets browser, which appears on the left of the window as you edit a page. The Assets browser provides an easy drag and drop interface that allows authors to add these files to pages.
Assets are normally visible to all authors, and when you add an asset, it is promoted as "new" to all authors at the top of the display in the Assets Browser. If you temporarily need to keep them private (e.g. a photo for an upcoming event, consider embedding them directly into your page, or use Private Authoring.
Assets is a handy place to centrally manage your images and other files, such as multimedia files, Word documents, spreadsheets or PDFs whether they are embedded in components or provided as downloads. Assets are readily available for use by everyone on your team, and can also be used on multiple pages (or sites) as needed to support your business needs. They also only need to be published once to be visible in every placement, whereas content embedded into a specific page must be republished every time that page is modified.
This is especially the case for large files. Hosting them in Assets instead of embedding them in your page reduces the load on our publishers. Referenced files are pulled from Assets when needed, instead of being loaded directly with your page. They also do not need to be published when your page is created or modified, which reduces the load on our servers.
If you must have a very large volume of content on a page (say over 200 MB), please let us know in advance before you publish it.
Making an Assets folder 'orderable':
By default, Assets folders are not orderable. Content is handled chronologically based on when it was uploaded, with the most recent additions at the bottom.
The view can be sorted by the various columns in Author, which will change how the assets display in Author, but these temporary changes are ignored by the UBCMS when using this content say in a Photo Gallery.The UBCMS uses the 'natural order'.
To impact how the assets are used by the UBCMS, you must first set the folder as 'orderable' in its Properties. and this step should be taken before any content is uploaded, definitely before any uploaded content is published. You can then reorder the assets as desired.
To be sure you are seeing the natural order:
And to 'fix' a folder that has been switched to 'orderable' or to change the settings for a published folder:
Documents, spreadsheets, slideshows and other assets must be accessible for use with assistive technology and presented in a format that is clear and well-organized whether they are embedded or linked from your Web page (e.g. through the File Download component).
Best practice: Make sure your original document is created accessibly before you upload it or convert it to another format such as a PDF.
Alternative text ('Alt text') is a best practice for all your UBCMS images and is often required for accessibility so screen readers can tell visually disabled users what they are not seeing.
For photo galleries, the image captions also serve as Alt text, which must be manually provided at the source for each image.
Please provide either the Alt Text, or the Description, or both, because the two can be applied differently in some photo components. For the Gallery:
Best practice, always provide Alt text whenever an image is uploaded into Assets.
Last reviewed: January 13, 2022
Located in the top left of the window.
The Adobe Experience Manager link links to the main Start page.
Located in the top right of the window.
This toolbar is hidden by the Command Menu when a page is selected .
Located in the top left of the window.
This dropdown loads the Side Panel located on the left side of the window. Additional information about the selected assets is available in separate Drawers.
Located in the top middle of the window.
Use this dropdown to navigate back up through the file tree from your selected folder.
Located in the top right of the window.
This tool selects all files in the lowest level displayed. Click the "X" or Escape key to deselect.
Located in the top right of the window.
The 'Create' button reveals a dropdown with choices to create the following:
Located in the top right of the window.
This unlabeled dropdown toggles different displays of the site pages. Typically a dropdown at the top provides navigation back up the tree. The List View allows many sorting options, which only affect the individual user's view, while the other views provide an 'Order' dropdown at the top of the window.
Natural order is by creation date (newest assets are last) but this can be manually reordered in List View if the folder is set as 'Orderable', preferably when it is created, or later in Properties. To see the natural order, go to the list view, and make sure none of the column headings has any up or down arrows next to them. Click the arrows if present one or two times until they go away. This is the natural order.
Located along the left side of the window.
On demand, a left sidebar called the Side Panel can be revealed to provide more information about a site and its pages. The Side Panel is revealed (or concealed) using the unlabeled Content Tree dropdown in the top left of the window.
The following options are provided. Keyboard shortcuts are listed as "(Alt-n)".
Note: up to ten versions total of an asset will be saved for 90 days and the most recent five versions are stored forever.
Located in the center of the window.
This is the heart of the console, displaying the actual pages that make up each website.
Depending on the View chosen, you can navigate through the parents to reveal their children and some information about each page. We recommend the List View. It is the only view that lists all details and allows reordering.
Located across the top of the window when an asset is selcted.
This tool bar appears when an asset is selected (click the thumbnail). Multiple assets can sometimes be selected and acted upon together.
* Up to ten versions total of an asset will be saved for 90 days and the most recent five versions are stored forever.
Located across the top of the window when an image is opened to Edit.
This tool bar appears when an image is opened for editing -- select the image then click Edit. Changes are applied to all iterations of the image and should be apparent immediately where the image is referenced -- be sure to publish these changes to the live version.
Please note these are very basic tools and the interface is tricky. Instead we recommend modifying your image before you upload it, or for existing images, download, modify, then re-upload.
Every UBCMS site has three sections: Sites, Shared Content and Assets.
To enter the Assets area (or 'Assets console'), click the link on the Start page as you first log into the UBCMS. Or, from any other console, click Adobe Experience Manager in the top left of the window to return to the Start page. Then click Assets + Files. Once there, the screen is labeled "Assets" in the top center.
Navigation is like the Sites Console. There is a Content Tree dropdown in the top left and a View dropdown in the top right.
The Content Tree will display a file tree of the entire Assets area. Navigate to the area of interest, select a folder, and the content will display in the tree and also in the center of the window.
Example: sites + www + president (Office of the President's assets) would be /content/dam/www/president and the URL will be https://ubcms-author.buffalo.edu/assets.html/content/dam/president.
Create a folder to house your assets in a more systematic way. Folder names form part of visible links to your assets, but are not otherwise visible to the public.
When creating a new folder (or uploading a new file), it is important to use human and machine readable language in your names. Separate words with hyphens and do not use spaces, underscores or special characters. For example, if you are creating a folder titled "Our Images," type "our-images" as the name.
Assets added to a folder are normally listed in the order they were added. If you wish to maintain the assets in a particular order that you set, or change the order later, select 'orderable' when you create the folder. You can also change that setting later in the folder's Properties, but if you do so, and any of the assets are published, you must unpublish the folder and its entire contents, then republish the folder and its contents to replicate that information for your live site.
We strongly recommend when you create a folder that you choose the 'orderable' option. And then immediately publish it to lock that in. If you later decide to change a folder to 'orderable', you must unpublish it and its contents, then republish it and its contents to replicate that information for your live site.
Several settings can be adjusted when a folder is created, or later in the folder Properties dialog box.
Select the folder in the Content Tree then click Properties in the Command Menu at the top of the window.
If you choose the same name as an existing asset in this folder, you will have the chance to Cancel, Keep Both, Replace, or Create Version. If you 'Keep Both', a number will be appended to the new asset's name (e.g. test.doc will become test1.doc). If you 'Replace,' the new asset will overwrite the existing asset.
New assets will be flagged as 'New' in the Assets browser for one day.
As a general rule, assets should be less than 50MB (in Assets or directly embedded on a page).
Note: up to ten versions total of an asset will be saved for 90 days and the most recent five versions are stored forever.
Images uploaded directly into components should be less than 6000 pixels in both height and width or they will not load and be flagged with a red 'X' in author. This restriction does not apply to images uploaded into Assets.
Allowable image formats include JPG, GIF, PNG and PSD (PhotoShop) and others. Most images are recompressed in JPEG format for optimal page performance. GIF and PNG images are kept in those formats to retain their unique features (lossless compression, selective color palettes, transparency).
In addition, when you add photos to the DAM, the text you enter in the Description field is the text that will appear in the caption section if the photos are being used in the Photo Gallery component.
Captions and Alt Text are required by state accessibility policies for images displayed in components, carousels or galleries. For individual images, these can be set in the component on the host page, but Photo Galleries draw this information from Assets and Photo Components also support this option.
To add or modify this information manually, select an asset then click Properties in the toolbar at the top of the window. You can now modify the meta-data for that file. (See webaim.org for tips on writing alt text.)
For an image used in a Photo Component, the Alt text can be set in the component on the host page, but photos also support pulling Alt text information from Assets.
When 'Get Alt text from Assets' is checked, the Photo Component's Alt text is populated with the value of the Alt text, Description or Title fields from the image's properties in Assets. If no Alt text is supplied, the component will use the Description test, but if that is empty, it will use the Title text.
If all three fields are empty, the Alt text field in the dialog box will be blank, and since text is required, you will need to either provide the required Alt text in image properties in Assets, or deselect the 'Get text from Assets' setting and provide the Alt text locally in the component.
For images used in a Photo Gallery, the caption below the image (in full-screen and on-page slideshow modes) and the alt tag (only in gallery/grid view) always match.
In a Photo Gallery, the caption below the image (in full-screen and on-page slideshow modes) and the alt tag (only in gallery/grid view) always match.
The value used by the Photo Gallery is the Description field when present, then the Alt Text value if no Description is provided, then the Title value if both Description and Alt Text are absent. If all three are blank (for any image in the gallery) there will be no alt text on that image.
Note: If more than one image in a gallery on your live website has the exact same caption (using the field logic above) or if more than one have no caption, an accessibility warning will be generated, "Link text used for multiple different destinations."
When you add a new asset that contains multiple segments (such as a PDF with several pages, or a powerpoint presentation with several slides), the UBCMS will break the document into sections, within a parent folder. This may look confusing, but to reference or link to the asset as a whole, select that parent folder.
Assets are normally visible to all authors, and when you add an asset, it is even promoted as "new" to all authors at the top of the Assets Browser. If you need to keep them private in Author (e.g. details of a special unannounced event or a restricted-use photo) consider embedding them directly into your page, or use Private Authoring. Also, remember that assets embedded on shared content pages are also visible to all authors.
List View provides the opportunity to sort the display of pages in each of the various columns. This is just for your personal view of Author, and has no impact on site navigation or lists, or your published site, but will perpetuate throughout Author until you change or undo this specification. The other views have a single 'Sort by' dropdown at the top of the page with several options.
Click the ^v button at the top of any of the columns (Title, Name, Modified, Published, Template, Workflow). The sequence is Ascending > Descending > Off (default), and in each case, the pages will be ordered in alphanumeric or chronological order as appropriate. Clicking the next column overrides the first choice. If you click through to Off, we recommend you reload the page to correctly see the default order.
The folder must be set as 'orderable' in Properties or you will not be allowed to change their order.
A more powerful way to sort your displayed assets is provided by the Filter (search) tool.
Open Side Panel and select Filters, or use alt+5 keyboard shortcut. This will provide a controlled search for the selected folder in Assets. You can ignore the search box, but choose from the available filters, including File Type, Last Modified, Status, and more.
Assets added to a folder are normally listed in the order they are added ('Date Created'), and this order is maintained by the UBCMS. Order is important when the assets are displayed in the Photo Gallery or when a list is created by child pages with no specific sort order.
Views allow the user to change their current view of the asset order (not the real order). List View has many sorting options, while the other views have a 'Sort by' dropdown in the upper right. To see the natural order, go to the list view, and make sure none of the column headings has any up or down arrows next to them. Click the arrows if present one or two times until they go away. This is the natural order.
If you wish a folder's assets to be in an order you maintain, select 'Orderable' when you create the folder, or later adjust that setting in the folder's Properties. Then switch to List View, click the 'domino' icon at the far right of an asset, then drag and drop it into the preferred position.
Note: if you later change the folder to 'orderable', and any of the assets are published, you must unpublish the folder and its entire contents, then republish the folder and its contents to replicate that information for your live site.
Before you delete an asset, make sure it is not being "referenced" by other pages (in other words, linked to or used as Shared Content). Failure to do so may result in broken links and missing content on your live site.
To delete an asset:
Deletion is permanent. No backups or versions are saved but we can sometimes get copies of deleted assets from our QA server. This contains a complete copy of the entire author environment that is renewed regularly.
Assets are added to your pages while editing the page. Use the Assets Browser in the Edit Console's SIde Panel.
The Side Panel appears to the left of the main page content when selected from the Toggle Side Panel tool. It provides access to Assets, Components and a Content Tree.
It is not possible to apply a shorter URL or redirect an existing URL to an asset. To get around this limitation, create a regular website page using the Redirect Template. Then input your file's location into the page's dialog box; e.g. /content/dam/www/eub/about_ub/UB-org-chart.pdf