--- label: 'Changing the layout for an entity' related: - core.appearance - core.content_structure - field_ui.manage_display - block.overview --- {% set content_types_text %}{% trans %}Content types{% endtrans %}{% endset %} {% set content_types_link = render_var(help_route_link(content_types_text, 'entity.node_type.collection')) %} {% set content_structure_topic = render_var(help_topic_link('core.content_structure')) %} {% set block_overview_topic = render_var(help_topic_link('block.overview')) %}

{% trans %}Goal{% endtrans %}

{% trans %}Configure an entity sub-type to have its fields displayed using a layout (see {{ content_structure_topic }} for more on entities and fields).{% endtrans %}

{% trans %}What are the parts of a layout?{% endtrans %}

{% trans %}A layout consists of one or more sections. Each section can have from one to four columns. You can place blocks, including special blocks for the fields on the entity sub-type, in each column of each section (see {{ block_overview_topic }} for more on blocks).{% endtrans %}

{% trans %}Steps{% endtrans %}

  1. {% trans %}Navigate to the page for managing the entity type you want to add the field to. For example, to add a field to a content type, in the Manage administrative menu, navigate to Structure > {{ content_types_link }}.{% endtrans %}
  2. {% trans %}Find the particular sub-type that you want to create a layout for, and click Manage display in the Operations list.{% endtrans %}
  3. {% trans %}Under Layout options, check Use Layout Builder. You can also check the box below to allow each entity item to have its layout individually customized (if it is left unchecked, the site will use the same layout for all items of this entity sub-type).{% endtrans %}
  4. {% trans %}Click Save. You will be returned to the Manage display page, but you will no longer see the table of fields of the classic display manager.{% endtrans %}
  5. {% trans %}Click Manage layout to enter layout management view. A default layout will be set up for you, with a single one-column section containing the fields on your entity sub-type.{% endtrans %}
  6. {% trans %}To remove the default section and start from an empty layout, find and click the Remove button for the default section, which looks like an X. Confirm by clicking Remove in the pop-up dialog.{% endtrans %}
  7. {% trans %}Add new sections, each with one to four columns, to your layout. For instance, you might want a one-column section at the top, a two-column section in the middle, and then a one-column section at the bottom. To add a section, click Add section and click the desired number of columns. For multi-column sections, set the column width percentages and click Add section in the pop-up dialog.{% endtrans %}
  8. {% trans %}In each section, click Add block to add a block. You will see a list of the blocks available on your site, plus a section called Content fields with a block for each field on your content item. Each block can be configured, if desired, with a Title, and for content field blocks, you can also configure the field formatter. Continue to add blocks to your sections until all the desired blocks and fields are displayed.{% endtrans %}
  9. {% trans %}Verify your layout. You can check Show content preview to show a preview of what your layout will look like, or uncheck it to see the names of the fields and blocks in each section.{% endtrans %}
  10. {% trans %}If needed, reorder the blocks by dragging them to new locations. If you hover over a block, a contextual menu will appear that will let you change the configuration of the block, remove the block, or Move blocks within the section using a more compact interface.{% endtrans %}
  11. {% trans %}When you are satisfied with your layout, click Save layout.{% endtrans %}

{% trans %}Additional resources{% endtrans %}