loading

Built-in vs. Custom Entity Types

What You’ll Learn

In this section, you will learn:

  • The difference between Built-in and Custom Entity Types
  • Best practices for when to use each type

Differences between a Built-in Type and a Custom Type

Entity types can either be built-in by Yext or custom-defined by you for your specific account(s).

Yext provides a number of “Built-In” Entity Types for common data objects, like Locations, Healthcare Professionals, Products, or Jobs. These entity types are pre-defined by Yext and Yext controls properties like the display name and the API name. You can add additional custom fields to these types, but you cannot remove fields defined on the Entity. Over time, Yext will expose more Built-In Entity Types as we observe common patterns or behavior or as we build out more Entity Types in our Knowledge Network.

Can’t find an entity type that describes what you’re trying to do? Not a problem!

Customers can also define their own objects called “Custom” Entity Types. Custom entity types can be used for any kind of data – each brand can control the name and the properties of these types as needed.

If you can, we recommend that you use Built-In types so that you can take advantage of any pre-built configurations and product-wide compatibility. Unlike Built-In types, Custom Entity Types are not compatible with Listings and may not be compatible with all Third Party systems / integrations.

Built-in Entity Types Custom Entity Types
Yext defines the core schema, customers can add additional custom fields to it Customer defines the schema by adding any Built-in or Custom Field to it
Compatible with Listings Yes No
Compatible with Pages Yes Yes
Compatible with Answers Yes Yes
Can control display name, API name, entity type description & all fields No Yes
light bulb
Tip
You should use Built-in Entities when you can. We create built-in types to make things faster and easier for you.
unit Quiz
+20 points
    Error Success Question 1 of 3

    What can you control for Custom Entity Types? (Select all that apply)

    Error Success Question 2 of 3

    Can you sync an entity of a Custom Entity Type to Google Maps?

    Error Success Question 3 of 3

    If you are trying to list a Location, should you use the Built-in Entity Type or should you use a Custom Entity Type?

    You're a star! ⭐️

    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