relationship

Multi-select post relationship. Today this is a thin alias over `post-object` with `multiple: true` forced on — same picker, same stored shape.

Stored value

number[] (default) OR post-object[] when `returnFormat: "object"` is set

Supports

  • Multi-select with drag-to-reorder
  • All `post-object` features (post type filter, taxonomy filter, return format, etc.)

Config options

postTypestring | string[]
WP post type slug(s) to search.
returnFormatstring
`"id"` (default) stores post IDs; `"object"` stores full post objects.
enablePostTypeFilterbooleandefault: false
Show a post-type dropdown in the picker (when multiple types are allowed).
enableTaxonomyFilterbooleandefault: false
Show taxonomy term dropdowns in the picker.
filterTaxonomies{ slug, label }[]
Taxonomies to surface as filters.

Example

json
{ "id": "ctrl_related",
  "type": "relationship",
  "label": "Related projects",
  "attributeKey": "related",
  "postType": "project",
  "parentPanelId": "panel" }

Gotchas

Heads up
Functionally identical to `post-object` with `multiple: true`. Pick whichever name reads better in your `block.fields.json`.