Entity views allow you to see which fields on an entity are relevant to Listings and Pages. There are two types: Publisher Fields and Pages Fields.

Entity views can be applied in Entity Edit for a single entity or in Bulk Edit on a set of entities. To apply a view, click the Publisher Fields or Pages Fields pill at the top of the entity and select your desired options from the dropdown.

Publisher Fields View

The Publisher Fields view filters an entity to display only the fields eligible to sync to a given publisher. It shows which fields are required or recommended, surfacing any publisher guidelines to help optimize your listings.

How to Apply

1. Navigate to Content > Entities and select the entity or entities you want to view.
2. Click the Publisher Fields pill at the top of the entity.
3. Choose your desired publisher from the dropdown and click Apply.

The entity will now show only the fields syncing to the selected publisher, each tagged as Required or Recommended.

4. An additional Publisher Field Options pill will appear. Click it to further filter to only Required or Recommended fields.

5. To remove the view, click the X on the pills at the top of the entity.

Required vs. Recommended Fields

Publisher Guidelines

Some fields display additional text when an entity view is applied. These publisher guidelines are suggestions, best practices, or extra context about how to use a field for the selected publisher. They are not validation rules.

For example: "Provide a Website URL and increase your probability to rank higher in Google search by 20-30%."

Not all fields or publishers have guidelines, so they will not always appear.

Which Publishers Are Available

All publishers in the Yext Publisher Network can be used in entity views. However, the publishers shown for a specific entity depend on:

Field Display in Publisher Views

The fields shown when filtering to a publisher depend on:

• Field syncing and mapping settings: Fields disabled from syncing to a publisher will not appear (e.g., if category syncing for Google is disabled, the Category field will not appear in the Google view). Override fields (e.g., Facebook Website Override) will replace the standard field for the relevant publisher.
• Field configuration: The order of fields does not change. Sections that would be entirely empty for the selected publishers are hidden.
• User permissions: Only fields the user has at least View permissions on will be displayed.

Note: You can select multiple publishers at once. The filtered view will show the union of all fields relevant to any of the selected publishers. There is currently no option to filter to only fields relevant to all selected publishers simultaneously.

Pages Fields View

The Pages Fields view displays which fields on a given entity are powering your live Pages templates. It filters the entity down to the fields pulled into the selected template's current production deployment.

How to Apply

1. Navigate to Content > Entities and select the entity or entities you want to view.
2. Click the Pages Fields pill at the top of the entity.
3. Choose your desired Pages site from the dropdown. The menu will expand to show the page templates within that site that are relevant to the entity being viewed.

4. Select your desired template(s) and click Apply.

How Fields Are Determined

The view reflects what is configured in the production deployment of the site. Any template changes not yet published to production (e.g., a new template or newly added fields) will not appear.

Fields are shown even if they have no data populated — the view displays all fields specified in the stream config, not just populated ones.

Using the following config as an example, selecting the location-pages template would display the name, address, mainPhone, description, and c_featuredFAQs fields:

stream: {
  $id: "location-pages",
  fields: [
    "id",
    "uid",
    "name",
    "address",
    "mainPhone",
    "description",
    "c_featuredFAQs.question",
    "c_featuredFAQs.answer"
  ],
  filter: {
    entityTypes: ["location"],
  },
  localization: {
    locales: ["en"],
    primary: false,
  },
}

Limitations

Availability on Entities

Note that entity views will only appear on entity types that are being used in Pages or Listings. For example, on entity types that do not sync to Listings, the Publisher Fields view option will not appear. Likewise, if a certain entity type is not eligible for use in Pages, the Pages Fields view option will not appear.

Filter Capabilities

If multiple publishers are selected, the filtered view will display the union of all fields relevant to any of the selected publishers. For example, selecting Google and Facebook will return fields syncing to only Google, only Facebook, and both Google and Facebook.

Currently, there is not an option to display the intersection of fields that are relevant to all the selected publishers. For example, it is not possible to select Google and Facebook and only display the fields that are relevant to both Google and Facebook.

Pages-Specific Limitations

• Entity views only work when viewing the entity that directly powers an individual web page. They cannot be used when viewing a related entity.
• Pages entity views are not supported for Classic Pages or Page Builder.