Skip to main content

Configuring the views of a content-type

🏗 Work in progress

The content of this page might not be fully up-to-date with Strapi 5 yet.

Depending on their type, content-types can be divided into 2 interfaces: the list view and the edit view. Both interfaces can be configured.

Configuring the list view

On the right side of the list view interface, right above the table, a settings button Cog icon is displayed. It allows to access the configurations that can be set for the list view of your collection type, and to choose which fields to display in the table.

✏️ Note

The configurations only apply to the list view of the collection type from which the settings are accessed (i.e. disabling the filters or search options for a collection type will not automatically also disable these same options for all other collection types).


Note also that the explanations below explain how to permanently configure which fields are displayed in the table of the list view of your collection type. It is also possible to configure the displayed fields temporarily (see Introduction to Content Manager).

Settings of a list view in the Content ManagerSettings of a list view in the Content Manager

List view settings

  1. In the list view of your collection type, click on the settings button Cog icon to be redirected to the list view configuration interface.
  2. In the Settings area, define your chosen new settings:
Setting nameInstructions
Enable searchClick on TRUE or FALSE to able or disable the search.
Enable filtersClick on TRUE or FALSE to able or disable filters.
Enable bulk actionsClick on TRUE or FALSE to able or disable the multiple selection boxes in the list view table.
Entries per pageChoose among the drop-down list the number of entries per page.
Default sort attributeChoose the sorting field that will be used by default.
Default sort orderChoose the sorting type that will be applied by default.
  1. Click on the Save button.

List view display

  1. In the list view of your collection type, click on the settings button Cog icon to be redirected to the list view configuration interface.
  2. In the View area, define what fields to display in the list view table, and in what order:
    • Click the add button Add icon to add a new field.
    • Click the delete button Clear icon to remove a field.
    • Click the reorder button Drag icon and drag and drop it to the place you want it to be displayed among the other fields.
  3. Click the edit button Edit icon to access its available own settings:
Setting nameInstructions
LabelWrite the label to be used for the field in the list view table.
Enable sort on this fieldClick on TRUE or FALSE to able or disable the sort on the field.
  1. Click on the Save button.
✏️ Note

Relational fields can also be displayed in the list view. There are however some specificities to keep in mind:

  • Only one field can be displayed per relational field.
  • Only first-level fields can be displayed (i.e. fields from the relation of a relation can't be displayed).
  • If the displayed field contains more than one value, not all its values will be displayed, but a counter indicating the number of values. You can hover this counter to see a tooltip indicating the first 10 values of the relational field.

Note also that relational fields have a couple limitations when it comes to sorting options:

  • Sorting cannot be enabled for relational fields which display several fields.
  • Relational fields cannot be set as default sort.

Configuring the edit view

In the edit view of a content-type, in the right side of the interface, a Configure the view button is displayed. It allows to access the configurations that can be set for the edit view of the content-type, such as the entry title, and the display of the fields of the content-type, including the relational ones.

Configuring the edit view of the Content ManagerConfiguring the edit view of the Content Manager

Edit view settings

  1. In the edit view of your content-type, click on the Configure the view button.
  2. In the Settings area, define your chosen new settings:
Setting nameInstructions
Entry titleChoose among the drop-down list the field that should be used as title for the entry.
  1. Click on the Save button.

Edit view display

  1. In the edit view of your content-type, click on the Configure the view button.
  2. In the View area, define what fields (including relational fields) to display in the list view table, in what order and what size:
    • Click the Add icon Insert another field button to add a new field.
    • Click the delete button Clear icon to remove a field.
    • Click the reorder button Drag icon and drag and drop it to the place you want it to be displayed among the other fields.
  3. Click the edit button Edit icon of a field to access its available settings:
Setting nameInstructions
LabelWrite the label that should be used for the field.
DescriptionWrite a description for the field, to help other administrators fill it properly.
PlaceholderWrite the placeholder that should be displayed by default in the field.
Editable fieldClick on ON or OFF to able or disable the edition of the field by administrators.
SizeSelect the size in which the field should be displayed in the Content Manager. Note that this setting is neither available for JSON and Rich Text fields, nor dynamic zones and components.
Entry title(relational fields only) Write the entry title that should be used for the relational field. It is recommended to choose well the entry title of relational fields as the more comprehensive it is, the easier it will be for administrators to manage the content of relational fields from the edit view.
  1. Click on the Save button.
Caution

The settings and display of a component's fields cannot be managed and reordered through the entry's edit view configuration page. Click on the Set the component's layout button of a component to access the component's own configuration page. You will find the exact same settings and display options as for the entry, but that will specifically apply to your component.

Note also that the settings are defined for the component itself, which means that the settings will automatically be applied for every other content-type where the component is used.