Structuring Your Knowledge Graph

Author: Jessie Yorke, Yext Administrator
Product: Knowledge Graph
Blog Date: September 2020

Hi there! 👋

My name is Jessie and here at Yext I am one of our Yext Administrators. As a Yext Administrator I build and structure Knowledge Graphs for brands across different industries, sizes, geographies, and more. This requires me to set goals, build a structure, and think creatively and strategically based on each organization's requirements and KPIs.

In this post we are going to discuss strategy and give you some tools to effectively think about structuring your own brand's Knowledge Graph!

Overview: What is a Knowledge Graph?

The backbone of the Yext Search Experience Cloud is the structured data that makes up the Knowledge Graph. This is the hub for all the facts about a brand and is stored in the format of an "Entity".

In its simplest form, an Entity is a collection of related data points that allow us to store structured data. An entity can represent physical things like Locations, Professionals, Financial Advisors, Doctors, Hospitals, Events, Products, etc.. They can also represent conceptual things such as Job Postings, FAQs, Services and more! Entities are the foundational building blocks of your Knowledge Graph and your brand's structured data.

Different Entity Types within a Knowledge Graph

Each Entity has its own relevant facts and data points that make it unique. Let's consider the example of a Location, Job and Product Entity. Each of these might host different data points and information in comparison to the other. Here are just a few facts and data points that may be relevant to each entity:

Example Entities

The Entity is very flexible — you can use one of Yext's built-in Entity types, or create your own by combining together the relevant fields (including custom fields)! Entities are designed to give you the flexibility you need to make your brand successful. You have complete control of their name, definition and use.

But how do you know which Entities you should include in your Knowledge Graph? How do you begin building the foundational data upon which all of your customer experiences will rest? I'm not sure where to start!

Don't worry - we got you.

💡Architecture & Strategy: Designing Your Knowledge Graph

To get started, you need to decide which types of Entities will comprise your Knowledge Graph. To do this, you should think about the following things:

1. Think about your ultimate goals and work backwards. It's often helpful to do a working session and draw your ultimate goals back to the solution you want to create. For example, imagine you are a financial services business, and your ultimate goal is to drive lead generation up by 2x. To expand your existing funnel, you want to capture more unbranded intent around common customer questions. This is a perfect use case for FAQ pages, and therefore you will need FAQ entities. Or instead imagine you are a brand new medical technology company that is about to launch a new website, a new product, and is looking for investors. Your goals are two-fold - 1) consolidate information for investors to feel comfortable partnering with you, and 2) gain a better understanding of your end-user (investor or customer) based on their online journey. This is the perfect use case for an Answers experience that includes information on FAQs, products, and the leadership team.

2. Consider all the Yext products you aim to implement. You want to keep in mind which Yext products you are ultimately looking to implement. This will inform whether you utilize built-in Entity Types or Custom Entity Types. Have you purchased Listings? Pages? Answers? If so, there are some considerations you'll need to take into account.

  • Listings: Yext has pre-built entity types that are purposefully built to sync information out to Yext's Listings Publisher Network. If you are looking to sync data to 3rd-party services you should plan to take advantage of those types such as: Locations, ATMs, Healthcare Professionals & Healthcare Facilities.

  • Answers: Answers can accommodate any sort of Entity Type, so there is a lot of room to be creative here! With Answers specifically, you should think through the lens of conversions (what types of entities will drive conversions) and user intent (what are users normally looking for on your website). Most Answers experiences will include FAQs at a minimum. The FAQ is a very flexible Entity type that can answer a wide breadth of questions. Including FAQs is also a great way to answer consumer questions on your website, and mitigate expensive support calls! Beyond that, it is often illuminating to look at your company website. The navigation items in your header are often indicative of where you normally drive your users, and can be a good place to start when considering Entity Types.

Pro Tip: You can always start small, and launch with fewer Entity Types, then leverage real user data post-launch to determine what Entity Types might be valuable to add.

3. Be forward thinking. Do you eventually want to launch your Loan Officers on listings? If yes, you should utilize the standard location entity type or any of the relevant built-in Entity types that can accommodate Listings functionality. Are you thinking about adding Answers or Pages in addition to your current Listings Solution? Perhaps you want to think about incorporating custom information that doesn't necessarily sync out to our Listings Publisher network, but would be great to include for landing pages or Answers searchability!

4. Consider entity relationships & how you may want to leverage them. The Knowledge Graph is a brain-like database that has the ability to relate different Entities together. These relationships are built via Custom Field linkages and are most applicable for simply organizing your data (think — relating a loan officer to the specific branch they work at) and leveraging them in Answers search results!

Leveraging Linked Entity Relationships

5. Extra Credit! Consider Automation Opportunities. If the data you are inputting into the Knowledge Graph is changing all the time, consider establishing some sort of integration with your source of your truth for ease of maintenance in the future. Learn more about our APIs and integration basics in the Introduction to APIs module.

🔧 Getting Started: Build Your Yext Knowledge Graph

Once you've finalized the Entity Types you want to include in your Knowledge Graph, you're ready to start building. Wahoo!

6. Enabling Built-in Entity Types. As a reminder, if you're using any of the built-in Entity types that aren't the default type within your account, you'll need to go into Account Settings and enable those types. These should be used as the default unless you have a specific use case that requires a custom type. Only these Entity types have the ability to sync information to our Publisher network.

Enabling Entity Types

7. Building Custom Entity Types. First things first, remember you CANNOT sync information to our Listings Publisher network via Custom Entity Types (CETs). Common use cases for CETs include brands that are taking advantage of Answers or Pages, or brands that are looking to store information and use the Knowledge Graph as their central database. When you create a Custom Entity Type, the only fields that are automatically included are the "Name", "Entity ID", "Label", and "Folder" — beyond that, the world is your oyster!

Creating a Custom Entity Type
  • Utilizing built-in fields vs custom fields. The fields in Yext are categorized similarly to the Entity Types — there are built-in fields associated with all built in Entity Types, or you can create a Custom Field if none of the built-in fields serve your project needs. As a rule of thumb, use built-in fields wherever possible. This reduces redundancy and limits the number of superfluous custom fields.

Pro Tip: Custom Fields can be used across multiple Entity Types, so it's smart to name them generically in case there is a future use case that can expand to another Entity Type.

  • [Answers Only] Consider Backend & Frontend when building CETs: If you'd like to feature any sort of description or photo on the frontend of Answers with this entity, those are easy fields to start with. You'll also want to incorporate 2 Call to Action fields which will eventually be leveraged as the calls-to-action within Answers. You should also consider what sort of fields or data you might want to index on the backend — for example, if you have a Product Entity you might want to include "Brands" as a field, so end users can query specific product brands and see relevant results.

8. Now that you've built your Knowledge Graph, think about new & cool ways you can use your structured data. For example, if you have always wanted a ChatBot feature on your site, consider perusing our App Directory for all our ChatBot partners. Perhaps your Event management software right now does not have a friendly user interface, and the information would be better managed from Yext and pulled into your internal software using an API.

For all information related to our APIs & App Directory Partners, check out and!

Yext App Directory

Keeping all this in mind, remember that you don't have to lay out elaborate blueprints and build everything in its entirety from the get-go. Here at Yext we believe strongly in the power of iterative development and incremental building - start off with a few critical elements and add on as you go.

When it comes to building your Knowledge Graph this is just the tip of the iceberg! These are just a few of the things I think about when structuring a Knowledge Graph for a brand, but everyone has their own goals, necessities, and style. To get a full training on how to structure a Knowledge Graph, check out the Knowledge Graph track and earn your badge!

All Blog Posts

Determine Location Intent in a Search Engine

Max Shaw, VP Product

One of the most common use cases for a search engine is finding something by a "location". Here are some basic examples: Cardiologist near Green Bay, Notary near me, Restaurants open now. These are all pretty simple queries, but getting these to work in a search engine is much more complex than you might imagine.

4 Methods for Increasing Site Search Clicks

Rick Swette, UX Research

We know good search drives business impact. It increases conversions and transactions, reduces search bounce rate, and boosts overall customer satisfaction. So, how do we get more people to trust and use site search? We embarked on a study to find this out.

How to Measure the Success of Your Site Search

Basil Polsonetti, Data Insights

Most brands know that site search is a feature their website should have, but unless the site is dominated by e-commerce, it’s often relegated as a check-the-box task when building a new website.

The Danger in Document-Level Sentiment Analysis

Calvin Casalino, Senior Product Manager

In order for your feedback to become an actionable item to help businesses provide a better experience, they need a way to analyze the granular content of all of their reviews, at scale.

Deep Dive into Duplicate Suppression

Dee Luo, Product Manager

Brands know the importance of having accurate information across all the apps, maps, and directories where consumers are searching for information. In a perfect world, powering that brand data and managing each of these listings would be enough to ensure that consumers consistently get the answers they're searching for.

Yext Answers Algorithm Update: Milky Way

Max Shaw, VP Product

Yext Answers is constantly improving it’s search algorithm to provide more relevant results over time. Milky Way is the first official upgrade to the Answers Algorithm and includes a series of important upgrades to provide better search precision and recall.

GMB API Update - Dedicated Food Menus

Dee Luo, Product Manager

On August 24, 2020, Google launched version 4.7 of its Google My Business (GMB) API. This update includes enhancements to how your restaurant locations can sync and display food menus on Google.

Structuring Your Knowledge Graph

Jessie Yorke, Yext Administrator

In this post we are going to discuss strategy and give you some tools to effectively think about structuring your own brand's Knowledge Graph!

Welcome to the Hitchhikers Program

Liz Frailey, VP Developer & Admin Experience

Welcome to Hitchhikers! We are so excited to have you join our mission of creating amazing search experiences for brands of all sizes.

Introducing: Yext Answers Plugin for WordPress

Alex Barbet, Product

Businesses of all sizes use both WordPress and Yext to build amazing client experiences, and as more and more brands around the world add the Yext Answers bar to their WordPress powered sites, we wanted to provide a way to drive their time-to-value even faster.

Yext’s Fall ‘20 Release is Now Live!

Nick Oropall, Senior Product Marketing Manager

For those of you who are new to Hitchhikers — Welcome to Yext's new training platform & community! Hitchhikers will be the home for all of Yext's product and release updates moving forward so we encourage you to create a free user and check out the platform!

Meet the Hitchhikers Team: Alyssa Hubbard

Alyssa Hubbard

Alyssa Hubbard began at Yext in the Upward Rotational Program. Now she is full-time on the Hitchhikers team, working to build a platform to empower our community of Yext power users.

Yext Answers Algorithm Update: Andromeda

Allie Allegra, Senior Product Marketing Manager

We are constantly making improvements to the underlying Answers algorithm. Our latest algorithm release, Andromeda, includes cutting edge improvements that optimize the overall search experience. With this release, our algorithm now has the ability to search semi-structured data. You can now opt-in to access these improvements depending on your configuration.

WCAG and Search: Developing an Accessible Search Experience

Rose Grant, Associate Product Manager

What’s WCAG? WCAG stands for the Web Content Accessibility Guidelines (WCAG). WCAG is not always black and white; its rules often have a variety of interpretations.

Now Available: Shopify Product Catalog Sync for Yext

Lilly Fast, Senior Business Development Manager

Shoppers have questions about your products, and your ability to answer will determine if they buy or if they bounce. But with rapid changes to your business, it can be hard to keep your product information consistently up-to-date.

Now Available: Yext Product Catalog Sync for Magento Commerce, an Adobe Company

Lilly Fast, Senior Business Development Manager

Shoppers have questions about your products, and your ability to answer will determine if they buy or if they bounce. But with rapid changes to your business, it can be hard to keep your product information consistently up-to-date.

A New Way to Search FAQS

Max Davish, Associate Product Manager

Semantic search is a new way of searching for FAQs. Instead of looking at keywords, it measures the similarity in meaning between two questions. Answers does this using BERT - the same revolutionary natural language processing technology that powers other Answers features like location detection and entity recognition.

How to Build Discoverable and High-Converting Landing Pages

Sonia Elavia, Senior Product Marketing Manager

Search is a massively important marketing channel. Fifty-three percent of website traffic comes from organic search, so it’s critical that businesses optimize for these experiences. But how do you actually build out a strong presence in organic search? Having search-optimized landing pages is critical.

Exporters: From Yext to Your Listings

Calvin Casalino, Senior Product Manager

Our Listings delivery pipeline ensures your data stored in the Knowledge Graph appears on Listings everywhere consumers are asking questions. How do we make sure your data is updated on all publishers as quickly as possible while still ensuring data is formatted properly for each endpoint? Yext’s Listings exporters.

2020: Hitchhikers Year in Review

Liz Frailey, VP Developer & Admin Experience

2020 has been a rollercoaster of a year for everyone for a multitude of reasons. On the Hitchhikers Team, we were able to overcome some of the year's obstacles to really transform the program.

Understanding the Answers Algorithm

Pierce Stegman, Data Scientist & Michael Misiewicz, Data Science Manager

See for yourself how the Answers algorithm works on the Understanding the Answers Algorithm site built by our Data Science team!

A Type System for Knowledge Graph Entities

Oscar Li, Software Engineering Lead

Our type system serves as the foundation of the Knowledge Graph by dictating the structure, validation, and display of fields. The type system guarantees the consistency and correctness of any field value retrieved from the Knowledge Graph. This makes it easier for our engineers to reason about code that handles particular fields, for our customers to manage their entity data, and for our publishers to trust the quality of our data.

3 Integrations That Can Help You Get More Out of Yext

Jonathan Gitlin, Content Marketing Manager, Workato

As a Yext user, you’re likely well aware of the platform’s product suite and the value each solution delivers. But did you know that you can provide even better search results for visitors, collect more reviews from customers, and analyze data more closely by integrating Yext with the apps and systems your team already uses?

Google’s Latest API Update: More Hours

Teddy Riker, Associate Product Manager

On February 25th, 2021, Google launched version 4.9 of its Google My Business (GMB) API. This update includes support for additional hours types, for options such as delivery, drive through, and more.

Spring ‘21 Release is Now Live!

Nick Oropall, Senior Manager of Platform Product Marketing

Yext's seasonal releases are always packed with new features and functionality to keep Hitchhikers on the cutting edge of search, and the Spring '21 Release is no different. Across the product suite, we have added new features that will help you to drive value and improve your user experience.