A container tag which iterates (loops) over a list of assets from one or more blogs.

<mt:Assets>
    <!-- tags here -->
</mt:Assets>

This container tag may contain any Asset function template tags.

Similarly, the mt:EntryAssets and mt:PageAssets tags will list all assets with the respective entry or page.

Attributes

• assets_per_row
• author
• days
• file_ext
• type
• lastn
• limit
• namespace
• offset
• sort_by
• sort_order
• tag
• blog_ids
• include_blogs
• exclude_blogs
• include_websites
• exclude_websites

assets_per_row

This attribute sets how many iterations the Assets tag publishes before setting the state that enables the AssetIsLastInRow AssetIsFirstInRow tags.

</mt:AssetIsLastInRow>

Supported values:

• intergers less than or equal to “100”
• auto - which selects the most aesthetically pleasing number of items per row based on the total number of assets. For example, if you had 18 total assets, three rows of six would publish, but for 16 assets, four rows of four would publish.

author

Selects assets uploaded by a single author.

Specify author’s username.

<mt:Assets author="beau">
    <!-- tags here -->
</mt:Assets>

days

Selects assets created in the last number of days specified.

<mt:Assets days="3">
    <!-- tags here -->
</mt:Assets>

file_ext

Selects assets by file extension.

Supports a comma-delimited list of file extensions.

<mt:Assets file_ext="gif, mp3, pdf">
    <!-- tags here -->
</mt:Assets>

type

Selects assets by asset type.

<mt:Assets file_ext="image">
    <!-- tags here -->
</mt:Assets>

Supports a comma-delimited list of asset types:

• image
• audio
• video
• file (new in MT5)

lastn

Limits the selection of assets to the specified number.

<mt:Assets lastn="3">
    <!-- tags here -->
</mt:Assets>

limit

A positive integer to limit results.

<mt:Assets limit="3">
    <!-- tags here -->
</mt:Assets>

namespace

Used in conjunction with the sort_by attribute when sorting by “score”. The namespace identifies the method of scoring to use in sorting assets.

offset

Used in coordination with lastn, starts N assets from the start of the list. N is a positive integer.

<mt:Assets lastn="1">
    <!-- special treatment for first asset -->
</mt:Assets>
<mt:Assets lastn="9" offset="1">
    <!-- alternate treatment for next 9 assets -->
</mt:Assets>

sort_by

Sort assets by value.

<mt:Assets sort_by="label">
    <!-- asset tags -->
</mt:Assets>

Supported values:

• blog_id
• created_by
• created_on
• description
• file_ext
• file_name
• file_path
• id
• label
• mime_type
• parent
• score
• url

sort_order

Supported values:

• ascend
• descend

tag

Selects assets with particular tags.

Supports expressions such as “interesting AND featured”).

<mt:Assets tag="foo AND bar">
    <!-- tags here -->
</mt:Assets>

Examples

<mt:Assets lastn="10" type="image" tag="favorite">
   <a href="<mt:AssetURL>">
      <img src="<mt:AssetThumbnailURL height="70">"
           alt="<mt:AssetLabel escape="html">"
           title="<mt:AssetLabel escape="html">" />
   </a>
</mt:Assets>

Related

• Template Loop Meta Variables offer conditionals for odd, even, first, last, and counter.
• MultiBlog template tags let you aggregate and publish assets from one or more blogs in your system, and apply criteria for filtering which assets are displayed.
• mt:EntryAssets
• mt:PageAssets