Relate allows you to fetch content from a relationship using a very simple tag syntax. Relate tags can even be nested inside each other.

It is designed to work hand in hand with the Relate field.

Learn by watching!
Check out the fundamentals screencast on Relate.


Let’s say you have a blog post with a Suggest field called similar_posts that you use to set, you guessed it, similar posts. That relationship data is saved as a YAML list of IDs, like so:

title: Why Bears are Awesome
  - 892hnfe983f
  - 980naf80d9a
Bears. Beets. Battlestar Galactica.

You’d then use the relate tag to fetch field data from those entries with a single tag.

<ul class="similar-posts">
  {{ relate:similar_posts }}
      <li><a href="{{ url }}">{{ title }}</a></li>
  {{ /relate:similar_posts }}


The parameters are inherited from the collection tag. Everything available there is available here.



When referencing a list of term values, this is the taxonomy that you'd like to pull them from. If you have a list of term IDs, this parameter is not necessary. More details


boolean true

By default, Statamic will convert taxonomy term values into actual term objects that you may loop through. This has some performance overhead, so you may disable this for a speed boost if taxonomies aren't necessary.

Last modified on February 14, 2018