Field sections are used to organize the fields that appear on the Entity Edit screen for all entities of the same entity type. In addition to the built-in field sections on an entity type, you can create new sections, move fields between sections, and add section dividers.
For more information on editing sections within each entity type, see Customize Entity Type Field Configurations.
Note: Making changes to field sections will modify the default field presentation. This can impact automatically translated content, or prevent your account from receiving automatic updates that Yext makes to default field presentations in the future. For more information, see the Default Field Presentation reference on Hitchhikers.
Add a field section
Field section names must be fewer than 255 characters and must be unique within a given entity type (e.g., you can't have two sections named "Business Details" on the Location entity type).
- Navigate to Knowledge Graph > Configuration and click the Entity Types tile.
- Click the entity type you want to modify and select the Fields tab.
From here, you can create a new field section, or copy an existing field section from another entity type.
Create a new field section
-
Click the Add dropdown wherever you would like to add a new section and select Add Section.
- You can also access this option in the left sidebar that lists your field sections. Find the place where you would like to add a new section and hover over it.
- Click the plus sign that appears and select Add Section.
-
Enter the information for your new section and click Save.
- (Optional) To add a translation for your section name, click Add translation. Select the desired language from the dropdown menu and enter the translated field section name.
Copy a section from another entity type
-
Click the More Actions dropdown at the top right of the page and select Add Section from Existing Entity Type.
- Click Select Entity Type and choose the entity type you want to copy a section from.
- Select the checkbox next to the desired sections and click Add Sections. This will also copy the fields in the sections.
Modify a field section
Field section names must be fewer than 255 characters and must be unique within a given entity type (e.g., you can't have two sections named "Business Details" on the Location entity type).
-
Locate the section you want to modify. Use the tools at the top of the section.
- Click the Collapse by default toggle to collapse this section. When you go to Entity Edit on an entity of this type, this field section will display as collapsed until a user expands it.
- Click the pencil icon to rename the section and/or modify translations for the section name. You can also do this by hovering over the section in the left sidebar.
-
To move a field section to a different position, hover over the desired section in the left sidebar. Click and drag to the desired position.
Delete a field section
- Locate the section you want to modify. Use the tools at the top of the section, or hover over the section in the left sidebar and click the trash can icon.
-
Select how you want to manage the fields in the section:
- Delete section & move all fields. Move the fields in the deleted section to a different section. Select the new section from the dropdown menu.
- Delete section, delete fields that can be deleted, & move fields that cannot be deleted. Use this option to remove fields from the entity type entirely. Any fields that are required for the entity type will be moved to a different section. Select the new section from the dropdown menu.
- Delete section & remove fields from entity type. This option only appears if all fields in the section can be removed from the entity type.
- Click Confirm.
Note: If the last section is removed from an entity type, fields that cannot be removed will be moved to the Other Fields section. Fields that can be removed from the entity type can either be moved to Other Fields or be removed entirely.
Add a section divider
Section dividers appear on the left sidebar in Entity Edit to group similar field sections.
To add a section divider:
-
In the left sidebar that lists your sections, hover between sections and click on the plus sign that appears. Click Add Section Divider.
-
Enter the information for your divider and click Save.
-
(Optional) To add a translation for your divider name, click Add translation. Select the desired language from the dropdown menu and enter the translated field section name.
-
(Optional) To add a translation for your divider name, click Add translation. Select the desired language from the dropdown menu and enter the translated field section name.
Other Fields section
The Other Fields section is a catch-all for fields that aren't organized into a different section. Usually this is because they were added to an entity type outside of the Field Configuration screen:
- On the Field Settings screen (Knowledge Graph > Configuration > Fields)
- Via Config as Code or API
The Other Fields section will always appear at the bottom of Entity Edit.
Save changes
To apply your changes to your entity type, click Save in the bottom right of the screen.