Recommended releases

Download Released

Important note: Entity Reference module was moved into Backdrop core in
version 1.23.0. Use of this module is no longer necessary and no further changes
will be made here. If you would like to report a bug or feature request against
Entity Reference module, file an issue in the main Backdrop CMS core repository

Provides a field type that can reference arbitrary entities. For example, there
could be "team" and "player" content types, and each player could have a field
where authors could select which team they belong to.


Install this module using the official Backdrop CMS instructions at


  1. To add an entity reference field to a node, navigate to Administration >
    Structure > Content types > [content type to edit] > Manage fields and
    add a new field. Add a title and select the entity reference field type.
    Select a widget: Select list, Autocomplete (Tags style), Autocomplete, or
    Check boxes/radio buttons. Save.
  2. From the Field Setting tab select the entity reference "Target type":
    Node, Comment, File, User, Taxonomy term, or Taxonomy vocabulary.
  3. From the Field Setting tab select select the Entity Selection Mode -
    Simple (with optional filter by bundle) is the default. Select how to
    Sort: Don't sort, A property of the base table of the entity, or A field
    attached to this entity. Select the sort field or property and the sort
    direction. Save.

Now when authoring content there is an option to make reference to another

Too many entities

Note that when using a select widget, Entity reference loads all the
entities in that list in order to get the entity's label. If there are
too many loaded entities that site might reach its memory limit and crash
(also known as WSOD). In such a case you are advised to change the widget
to "autocomplete". If you get a WSOD when trying to edit the field
settings, you can reach the widget settings directly by navigation to


Replace ENTITY-TYPE and FIELD_NAME with the correct values.


To submit bug reports and feature suggestions, or to track changes:

Current Maintainers



This project is GPL v2 software. See the LICENSE.txt file in this directory for
complete text.