Reference Field Upgradation

On 29th July 2019, we introduced a new version of the Reference field that provides referencing to multiple content types. Here's what changed:

  • For stacks created after 29th July 2019, you will automatically be using the upgraded Reference field.
  • For stacks created before 29th July 2019, your Reference field will continue referencing a single content type, but you can upgrade to the new version by updating the schema of your Reference field (shown in table below) in your content type.

When you upgrade your Reference field, the input format of your Reference field changes from array of strings to array of objects. The change in the format of the Reference field is as follows:

    "ref_field": ["blt33a3333333df3c33",...]
    "ref_field": [{<
      "uid": "blt1111fe11e111111f",
      "_content_type_uid": "footer"

Publish Entry

After upgrading/downgrading the Reference field, you need to save the entry and then publish it to see the field in action.


  • The max number of content types that can be added into a single Reference field is 10.
  • The max number of entries that can be added in a multiple content type Reference field is 100.
  • The "include reference" depth for multiple content type Reference field is 3.
Was this article helpful?