Managing assets

Browsing assets

You can browse the Magnolia DAM in three views:

  • Tree view

  • List view

  • Thumbnail view

Tree view displays a hierarchical tree, including the folder structure.

Magnolia Assets app - tree view

List view displays the items individually.

You can sort them alphanumerically by clicking the column headings.

Magnolia Assets app - list view

Thumbnail view displays thumbnail images of the assets. There is a zoom control at the top for resizing.

Magnolia Assets app - thumbnail view

How to handle large amount of assets

The DAM can handle a very large number of assets. However, if you have more than 20,000 assets, you should organize them into folders. If your number of assets drastically exceeds the 20,000 guideline, we recommend that you use an external storage system with our DAM Connector Pack, our DAM API, or one of our Incubator modules extensions.

How many assets should I put in a folder?

As a rule of thumb when using JCR for assets, you should keep it to about 500 assets per folder. This is independent of the asset type. So, whether it’s an image, pdf, or some other type of asset, let’s try to keep it under 500.

Avoid storing too many assets in the same folder. Instead, create subfolders and organize your assets. Storing too many assets within the same folder may lead to performance issues. If you need a large and unstructured flat list of assets, disable the thumbnail and list views.

Supported file formats for preview generation

Image formats

The most common image formats are supported, excluding:

  • image/x-icon

  • image/x-portable-bitmap

  • image/x-xpixmap

  • image/x-portable-graymap

  • image/x-cmu-raster

  • image/x-portable-pixmap

  • image/x-xbitmap

  • image/x-rgb

  • image/x-xwindowdump

  • image/x-cmx

  • image/cis-cod

  • image/ief

Video formats

The following video formats are supported:

  • video/mpeg

  • video/webm

  • video/mp4

  • video/ogg

Audio formats

The following audio formats are supported:

  • audio/mpeg

  • audio/webm

  • audio/mp4

  • audio/ogg

  • audio/aac

  • audio/aacp

  • audio/flac

  • audio/wav

  • audio/x-wav

  • audio/mp3

Character restrictions

Website content, asset, configuration and everything else is stored in the content repository. Each item is stored in a node. The node name is generally displayed in the first column in AdminCentral, for example the page name in the website workspace and asset name in the dam workspace. Besides being an internal reference to the node, the name is also used for various purposes such to create a page URL.

Character restrictions apply only to node names and not to other user-entered content. For example, you can only use certain characters in a page or asset name but any character in the page or asset title. When a disallowed character is used it is automatically substituted with a hyphen (-).

The info.magnolia.cms.core.Path class governs character restrictions. All alphanumeric characters (a-z, A-Z, 0-9), hyphen (-) and underscore (_) are safe to use in node names. We recommend that you use lowercase letters separated by a hyphen.

Invalid characters

JCR 2.0 specification defines the following invalid characters in a local name.

Common Name Unicode Code and Name

Space

0020 SPACE

*

Asterisk (Star)

002A ASTERISK

/

Forward slash

002F SOLIDUS

:

Colon

003A COLON

[

Left square bracket

005B LEFT SQUARE BRACKET

]

Right square bracket

005D RIGHT SQUARE BRACKET

|

Vertical bar (Pipe)

007C VERTICAL LINE

Node names are used to create URLs and cannot contain characters that are disallowed or have special meaning in URLs. These conventions are established by the Internet Engineering Task Force (IETF) Network Working Group on URLs.

Common Name Unicode Code and Name

!

Exclamation mark

0021 EXCLAMATION MARK

#

Number sign (Hash)

0023 NUMBER SIGN

%

Percent sign

0025 PERCENT SIGN

'

Apostrophe

0027 APOSTROPHE

(

Left parenthesis

0028 LEFT PARENTHESIS

)

Right parenthesis

0029 RIGHT PARENTHESIS

+

Plus sign

002B PLUS SIGN

/

Forward slash

002F SOLIDUS

;

Semicolon

003B SEMICOLON

?

Question mark

003F QUESTION MARK

^

Caret

005E CIRCUMFLEX ACCENT

Characters disallowed by Magnolia

Common Name Unicode Code and Name

&

Ampersand

0026 AMPERSAND

=

Equals sign

003D EQUALS SIGN

@

At sign

0040 COMMERCIAL AT

Apart from the exceptions above, Magnolia allows you to use the full UTF-8 character set for node names and other properties, but UTF-8 encoding is disabled by default.

See UTF-8 in pages names for instructions on how to enable it. When enabled, all special characters and notations covered by the Unicode specification can also be used.

The dot character (full stop, Unicode 2E) can be used in node names with the single limitation that it cannot be the first character. You can create a user john.smith, a page article.one, a document Magnolia-Flyer-4.0.pdf, a configuration node option.one or a JavaScript file jquery.tabtree.

Searching for an asset

To search for an asset, use the Find Bar at the top of the UI:

Find Bar with results

You can also narrow your search. Click the funnel button on the right side and refine your search using the options provided:

Find Bar with search filter options

Extend your search

Uploading a single asset

To upload an asset:

  1. Select a parent folder or upload the image at the root level.

  2. Click Upload asset.

  3. Select a file to upload or drag and drop it into the Media field.

Upload asset dialog

  1. The file uploads.

  2. For images, the image details and a thumbnail displays. You can edit the image in Magnolia.

Uploaded asset with asset details

For other assets, the file details and an asset type icon displays.

Import a zip file with the assets app

You can upload a ZIP file in the Asset app in order to import multiple assets.

To import a ZIP file:

  1. Click Upload ZIP archive.

  2. Select a location. You can choose between:

    1. Extract into new folder – Adds a new parent folder (default).

    2. Extract here – Extracts the ZIP archive directly into the current folder.

  3. Browse to the file.

  4. In Encoding, select UTF-8 or CP437, depending on what system the ZIP file was created on.

  5. Click Save.

The assets are imported like this:

Extract into new folder Extract here

Assets to be extracted

Extracted assets

In the default configuration, the dialog does not have a field for renaming the filename of the asset.

Filename field in the asset upload dialog

To read more on how to add the field to the dialog head over to assets configuration.

Uploading an asset from another app

You can upload an asset into the Magnolia DAM also from any other app that can browse the DAM, for example when creating a new contact in the Contacts app. The procedure and actions are identical to those in the Assets app and work in exactly the same way. You can define app-specific metadata fields which can be different from the standard metadata fields available when uploading in the Assets app.

Downloading assets

You can download assets either individually or in bulk from any folder within the Assets app.

  1. Select the asset(s) you want to download.

  2. Click Download asset(s) in the action bar.

  3. In the download dialog that appears, you can choose the location of where you want to download and change the name of the file if needed ― this step only applies if your browser is configured to prompt before starting each download.

If you download multiple assets, they are compressed and downloaded as a ZIP file.
You can configure the ZIP file name and the size limit of the downloaded files in the Resource Files app. For more information, see how to configure asset downloads.

Deleting an asset

Versioning is enabled in the DAM. This allows you to restore previous versions of an asset or folder. The delete action marks the node for deletion and the deletion is completed on publication of the deletion.

To delete an asset or folder:

  1. Select an item.

  2. Click Delete folder/asset.

  3. Confirm your action in the dialog. This marks the node for deletion and creates a restorable version. The item icon (folder or node) is replaced with the trash bin.

  4. Click Publish deletion to complete the deletion. At this point you can cancel the deletion by clicking Restore previous version.

Exporting and importing assets

In the dam workspace, asset data are stored as binary data under the jcr:data subnodes. If you export an asset (or folder) from the app, an XML file will be exported and the data will be part of it. An XML file is therefore expected if you want to import an asset.

Exporting

To export an asset or folder:

  1. Select an item or folder.

  2. In the Action bar, click Export.

The exported XML file will contain also asset (folder) metadata such as mgnl:activationStatus. If you delete the asset on the author instance, publish the deletion and reimport the asset to the instance, the asset will retain the publication status even though it no longer exists on the public instance.

Importing

To import an asset or folder:

  1. Navigate to the location where you want to import the data.

  2. In the Action bar, click Import.

  3. In the Upload dialog, click Upload.

  4. Select an XML file or drag and drop it into the File area.

  5. Click Import.

Asset metadata

The metadata fields are located in the Asset dialog. You can set metadata when uploading or add/edit it by clicking Edit asset to open the dialog.

Magnolia native metadata

The system records certain data automatically, with such fields typically disabled. By default, the following fields cannot be edited:

  • Describe asset using: The supported metadata standard. By default, the Simple Dublin Core Metadata Element Set (DCMES) is supported. You can customize Magnolia to support different standards.

  • Identifier: An unambiguous reference to the resource within a given context. An alphanumerical string is used to identify and reference the asset. Editors can move assets without breaking links in the DAM.

  • Type: The nature or genre of the resource.

  • Creation Date: Date of upload.

  • Modification Date: Date of last modification.

  • Creator: An entity responsible for creating the resource (uploading the asset).

Dublin Core metadata

Magnolia supports the Simple Dublin Core Metadata Element Set (DCMES) standard by default and the following fields are available:

  • Caption: The asset caption.

  • Language: Language tag of the asset. Recommended best practice is to use a controlled vocabulary such as RFC 4646.

  • Title: Asset title.

  • Subject: The topic of the asset. Typically, the subject will be represented using keywords, key phrases, or classification codes.

  • Coverage: Scope of the asset. Typically this refers to a place, period or jurisdiction.

  • Description: Full description of the asset.

  • Publisher: Original publisher of the asset if being republished from another source.

  • Contributor: Use to name asset contributors.

  • Rights: Type of copyright.

  • Source: A related asset from which this asset is derived.

  • Relation: Related assets.

Setting alt attributes

The alt attribute of an img tag specifies alternative text (alt-text) for an image when that image cannot be displayed on a page. Its primary use is for accessibility purposes. For more, see Web Content Accessibility Guidelines. Use concise text that serves the same function as the image when writing the alternative text.

The default alt-text comes from the image’s title field in the Assets app. However, if an Alt-text field is defined as part of a content app, the Alt-text field in the content app takes precedence.

Check alt-text with Developer tools

To double-check alt-text was added to your image, use the Inspect tool in your browser to see the structure of the page and look for the image info.

Alt-text shown in browser dev tools
  • Assets app

  • Content app

If set in the Assets app and not explicitly defined in a content app, the image title serves as the alt-text.

Alt-text field in Stories app

If set in a content app, the field here takes precedence over the image title defined in the Assets app and serves as the alt-text.

Alt-text field in Stories app
Feedback

DX Core

×

Location

This widget lets you know where you are on the docs site.

You are currently perusing through the DX Core docs.

Main doc sections

DX Core Headless PaaS Legacy Cloud Incubator modules