Skip to main content
Relation fields connect one CMS entry to another entry, or to supported Plato records such as menu products and menu categories.

Write Relation Values

Single relation:
Multi relation:
Plato validates relation ids before saving. If an id does not exist in the API key workspace, the request fails:

Read Relation IDs

If you select a relation field without nested fields, Plato returns the stored id or ids.
Response:

Expand Relations

Use nested selection to expand related CMS entries.
Response:

Relation Depth

maxDepth controls how far nested relations can expand.
Default depth is 3. Maximum depth is 6. Keep depth low for public pages.

Supported System Relation Targets

CMS relation fields can also target supported Plato records. Currently supported system relation targets include:
  • MenuProduct
  • MenuCategory
When expanded, system records return: