Skip to content

Instance · Data

Boolean

Last updated 1 November 2026

The Boolean field type: a yes or no value shown as a toggle, and its Appearance settings.

A Boolean field holds yes or no: true or false. Use it for anything with two answers, such as Published, Featured or Subscribed. In the admin it appears as a toggle switch.

The UI element

A Boolean field has one UI element, Toggle, and it is the default. There is nothing else to choose.

The Appearance tab

SettingTypeRequiredMeaning
Show in table viewToggleNoShow the field as a column in the items list
Sortable in table viewToggleNoLet people sort the items list by this field
Help Text (Tooltip)TextNoA short note shown beside the field, to explain what it means
Column Width in table view (%)NumberNoThe column width as a percentage. Left empty, the width is automatic

A Toggle cannot be marked as mandatory, because a switch always has a value.

Example: read a Boolean in GraphQL

query featured_items {
  records(
    per_page: 10
    filter: {
      table: { value: "product" }
      properties: [{ name: "featured", value_boolean: true }]
    }
  ) {
    results { id featured: property_boolean(name: "featured") }
  }
}

Use value_boolean to filter and property_boolean to read, so the value comes back as true or false rather than as text. Across the 28 tables on the docs.insites.io instance, 32 fields were Boolean when read on 1 November 2026.

Note

The UI element and Appearance settings come from the Data module source (October 2026: fieldTypes.js, uiElements.js and Appearance.vue).

Common mistakes

  • Filtering with value: "true". It compares as text; use value_boolean: true.
  • Writing a long tooltip. Keep it to one sentence.
  • Using a Boolean for a choice that may grow past two answers. Use a String field with a Select instead.