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
• 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