Not a developer? Go to

Plugin and Theme Directory

Related Items v0.4

By Dan Wolfgang
Posted May 19, 2011, in Entry & Page.


Related Items provides a custom field type that allows users to relate the current object to any Taggable object. Said differently, with this custom field you can relate a system object (Entry, Page, Category, Folder, or User) to Taggable objects: assets, entries, and pages.

For example, a Related Items custom field configured to relate Assets to Pages would allow the published Page to display related Assets.

Use the Related Items custom field by entering a tag or tags in the field. The resulting matches are displayed in a "preview" area to help ensure the correct match was found.



To install this plugin follow the instructions found here:


Related Items can be configured at the Blog level. Visit Tools > Plugins to find Related Items, then click Settings.

The Show a Preview option is enabled by default and will display tag matches.

Related Items Count is the number of items returned in the preview area. Use this setting to ensure you don't accidentally grab thousands of items, for example. (The total number of found items is shown in the preview area if it exceeds the Count value set here.)

If you want to use a Related Items field in your theme, specify related_items_tags as the "type" in the field definition.


Create a Related Items custom field as you would any other custom field:

  • Go to Preferences > Custom Fields in your blog or from the system overview (fields defined at the System level will be available to all blogs).
  • Click "New field"
  • Set the System Object for the field (Entry, Page, etc). This is the type of object you want the target items to be related to.
  • Give the field a Name (ie: "Documentation Pages") and optionally a Description.
  • Set the Type of the field to "Related Items Tags."
  • Set Relate Items of Type to the type of objects that will be related through this field (entry, page, etc).
  • If this will be a required field, set Required.
  • Note the field basename and template tag for later use.
  • Save the field.

On the Edit Entry (or Edit Page) screen:

  • In the upper-right select Display Options, select your new Related Items field to make the field visible.
  • Enter some tags in the field and see the preview appear.
  • Save the entry.

Template Tags

Related Items provides one template tag, the block tag RelatedItems. This tag creates on object loop of the related items, and provides the normal meta loop variables as well (__first__, __last__, __even__, __odd__, __counter__). The tags has one required argument: basename. This should be set to the basename of the field you want to list related items for. Additionally the tag accepts both blog_id and lastn arguments. Setting blog_id will tell the tag to pull related items from a different blog from the one currently in context. Setting lastn will limit the returned results to this number. By default, the tag will return the number set in the plugin settings (defaults to 5).


In this example, a Related Items field was created for Entries, relating to Assets. The tag EntryDataRelatedAssets and the basename entry_data_related_assets was created for this field. In the entry template this code could be used to generate a list of Assets related to the Entry:

<mt:IfNonEmpty tag="EntryDataRelatedAssets">
    <mt:RelatedItems basename="entry_data_related_assets">
        <li><a href="<mt:AssetURL>"><mt:AssetLabel></a></li>


Movable Type versions: 4.3


Perl Artistic


Dan Wolfgang

Dan is an engineering creative and uses his vast knowledge of the web to solve unique client problems with specialized solutions. Complex or straightforward, his focus is to find the most efficient, functional, elegant, and stable solutions for each project. 10 years in web engineering and 14 more in the print publishing industry give him a special insight to the needs, restrictions, and workflows of content publishers, both traditional and new media. Dan is an active Movable Type community member who has written and contributed to countless plugins including some of the most popular: More Custom Fields, Poll Position, and Asset Image Quality.

Twitter: @danwolfgang