Configuration Labels | Yext Hitchhikers Platform

What You’ll Learn

In this section, you will learn:

  • What a version label is
  • Staging vs. Production labels and best practices

Version Overview

A configuration version is a unique instance of a saved configuration. Whenever you make a successful edit and save to your config (whether through the UI or JSON), it will create a new version. You will see your various configuration versions in the “Configuration Versions” of your selected experience:

pointing out Configuration Versions section

If you ever want to reference an old version of your config, you are able to download configuration versions directly from the “Configuration Versions” screen above.

Staging vs. Production Labels

When you go to build the frontend of Search (which you’ll learn about in a later module), you will have a Staging instance and a Production instance of your Pages site. Version Labels allow you to pin a specific configuration version for use in Staging or Production. The Staging instance of the site is where you will want to see your changes and understand how your config edits impact the search results. It is a safe, “sandbox” environment for QA and approve of changes before they go live to Production.

It is a best practice to pin the Staging instance of your Search experience to the “LATEST” config tag, like below:

Configuration Labels section with label example

This will allow you to always see the latest version of the configuration in the search results on your staging site, allowing you to easily test any of the changes you made before you set your Production label to that same version.

You will never want to set your Production label to “LATEST”, because config changes should always be tested in Staging first. It is safe to switch your Production label up to a new version once it’s been fully tested. In the example above, we can switch the Production label to “6” after Staging testing is complete. Again, always make sure your Production label is set to an explicit version label number and never the “LATEST” tag.

Testing Versions in Test Search

Test Search allows you to run and compare queries by version (either a specific version number, Staging, or Production). Simply use the drop down within Test Search to select a Search Configuration version and then run your search.

navigating to search configuration


unit Quiz
+20 points
Daily Quiz Streak Daily Quiz Streak: 0
Quiz Accuracy Streak Quiz Accuracy Streak: 0
    Error Success Question 1 of 2

    Which of the following is NOT true of configuration versions and labels?

    Error Success Question 2 of 2

    True or False: A successful save of the config file will automatically create a new config version, which you can then use within “Configuration Labels” to associate the label to a Staging or Production version of the site.

    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
Feedback