The Value Spec system in Uncountable enables teams to reference and extract information from entities using a flexible syntax. It plays a key role in dynamic form logic, data lookups, and automation across the platform.

Within the Form Admin, there are three related tabs that support this system: Value Spec, Value Spec Properties, and Value Spec Docs. This article outlines the purpose of each and how they work together to support powerful form configurations.

Value Spec Tab


The Value Spec tab is a testing environment for building and previewing value spec phrases before using them in the platform. It allows users to explore what data is accessible from a given entity and verify the output of a value spec expression.

To test a value spec phrase:

  1. Select an Entity Type (A).
  2. Choose a specific Entity (B).
  3. Write a value spec phrase in the Test Value Spec field (C), such as ref:fields, to access information stored on that entity.

Once entered, the Evaluation Sample window (D) will show the result of the phrase, helping you verify that the output matches what you expect.

Screenshot 2025-04-15 at 12.34.23 PM.png

<aside> <img src="/icons/book_gray.svg" alt="/icons/book_gray.svg" width="40px" />

For guidance on syntax, expressions, and capabilities, see our in-platform Value Spec documentation (Value Spec Docs tab) or dedicated Value Spec article.

</aside>

Value Spec Properties Tab


Some information on an entity (for example, Test Samples on an experiment or the Created Date on a Task) isn’t accessible through the standard ref:fields phrase. The Value Spec Properties system makes it possible to reference this data by defining custom, reusable properties.

To create a value spec property:

  1. Open the Value Spec Properties tab and click + Create.

    Screenshot 2025-04-15 at 12.05.49 PM.png

  2. In the modal, configure the following:

    1. Select an Entity Type.

    2. Choose a Property Type:

      1. Listing Column – references a column from an entity listing.
      2. Value Spec Snippet – creates a reusable snippet of value spec logic.
    3. Add a Reference Name. This is how you’ll reference the property in value spec expressions.

    4. If using a listing column, select the specific column you want to expose.

      Screenshot 2025-04-15 at 12.05.26 PM.png

Once saved, this property becomes available for use in value spec expressions across the platform.