loading

What is a Field

What You’ll Learn

In this section, you will learn:

  • What a field is
  • Examples of fields on some built-in types
  • The “field is a field is a field” principle

Fields Overview

As you learned in the Entity Types Module, entities are the core objects stored in the Knowledge Graph and fields provide additional information about each entity type.

Each Entity Type comes with a number of Yext pre-built fields and you can add additional custom fields as needed. Remember (as we showed in the Entity Types Module) there are some fields that are on all entity types – built-in or custom. These include:

  • Entity ID (unique identifier)
  • Name
  • Folder
  • Labels

Here are some example fields on some of the built-in Yext types –

Location:

  • Name
  • Address
  • Phone
  • Hours
  • Description
  • Logo
  • etc.

Event

  • Name
  • Start/End Date/Time
  • Event Location
  • Ticket URL
  • etc.

Healthcare Professional

  • Name (First, Middle, Last)
  • NPI
  • Office Address
  • Office Phone
  • Headshot
  • Photo Gallery
  • Education
  • etc.

Restaurant

  • Name
  • Address
  • Hours
  • Description
  • Logo
  • Attire
  • Price Range
  • etc.

Job

  • Name
  • Job Location
  • Description
  • Keywords
  • etc.

Additional fields are also automatically enabled if you are subscribed to certain publishers. For example, if your package includes Google My Business, your Location entities will also have fields like Google Cover Photo or Google My Business attributes.

All fields have a few properties:

  • a Type, like string, phone, or url
  • a Display Name, like “Keywords”, “Main Phone”, or “Description” used to reference the field in the UI
  • an API name, like description or c_customfield used to reference the field in the API
  • Validation, like maximum character counts, count of items for lists, or aspect ratio for photos

An important tenet of fields in Yext Data Modeling is that “a field is a field is a field”. This means that, once-defined, a field maintains the same properties like Name and Validation no matter where it appears. Fields are often shared between types – like the Description field – but no matter where it appears it will have the same validation, API name, and UX.

Field is the same no matter what type

In this example, the Name field is present on each of these types and its validation and UI presentation is the same.

unit Quiz
+20 points
    Error Success Question 1 of 3

    True or False: The same field can have different validation on a Location entity and an Event entity.

    Error Success Question 2 of 3

    Do available fields change depending on what publishers are in your package?

    Error Success Question 3 of 3

    Which fields are present on all entity types? (Select all that apply)

    You're out of this world! 🌎

    You've already completed this quiz, so you can't earn more points.You completed this quiz in 1 attempt and earned 0 points! Feel free to review your answers and move on when you're ready.
1st attempt
0 incorrect