Overview
Statamic relationships are defined by storing an id
or handle
of one piece of content (an entry, term, or user for example) in a variable on another piece of content. Once linked in this simple-but-specific manner, you can fetch and display the related content by using the variable in your templates.
Fieldtypes
There are 12 fieldtypes that manage relationships in one fashion or another. When you use these fieldtypes in your blueprint, the relationships are automatically resolved on the front-end of your site and you can work directly with the data it references.
- Assets
- Collections
- Entries
- Form
- Link
- Sites
- Structures
- Taxonomies
- Taxonomy Terms
- User Groups
- User Roles
- Users
Example
Let's use this example product entry to walk through displaying data from the three relationships: photo, author, and related products.
# /content/products/wayne-gretzky-pog-collection.md
title: Wayne Gretzky Pog Collection
price: 2495.00
template: products.show
id: 123-1234-12-4321
photo: products/gretzky-pogs-FINAL-(2).jpg
author: abc-abcd-ab-dcba
related_products:
- 789-7890-78-0987
- abc-1234-bc-4eba
Field Breakdown
-
id
is the unique identifier given to this particular entry -
photo
is a reference to an asset image of the product (why didn't they clean up the filename?) -
author
is the id of the user who created this entry -
related_products
is an array of other product entry ids
Templating
In this following template example you can see how easy it is to use the data from related entries, assets, and users. You don't need to write queries, request data filter results, or anything complicated. As long as you've used the appropriate fieldtypes in your blueprint, the data will be ready and waiting for you to use in your view template.
<!-- resources/views/products/show.antlers.html -->
<div class="product">
<div class="flex justify-between">
<h1>{{ title }}</h1>
<h2 class="text-green">${{ price }}</h2>
</div>
<img src="{{ photo:url }}" alt="{{ alt }}">
<p>Listed by: {{ author:name }}</p>
</div>
<div class="mt-8">
<h3>Related Products</h3>
<div class="flex flex-wrap -mx-2">
{{ related_products }}
<div class="w-1/2 p-4 border m-2">
<div class="font-bold">{{ title }}</div>
<div class="text-green">{{ price }}</div>
<img src="{{ photo }}" alt="{{ alt }}">
</div>
{{ /related_products }}
</div>
</div>
Manual Fetching
If you aren't using a relationship fieldtype but do have an id
or handle
to fetch data from you can use the get_content tag.
<!-- You can hardcode the ID -->
{{ get_content from="123-1234-12-4321" }}
<a href="{{ url }}">{{ title }}</a>
{{ /get_content }}
<!-- Or pass the variable holding it -->
{{ get_content :from="related_id" }}
<a href="{{ url }}">{{ title }}</a>
{{ /get_content }}