Skip to main content
The Data Schema tab in project Settings lists discovered contact attribute paths. You can set each path’s visibility to control where it appears in rule builders and contact API responses. Visibility does not block template rendering.
Data Schema management lives under Settings → Data Schema and requires the project admin role. A scheduled schema sync discovers new paths from stored contacts and events.

​
How the schema builds itself

An hourly schema sync scans recently updated contacts and events for new leaf paths. A full sync can also rebuild the index from stored records. The Data Schema table shows contact paths with:
  • The path itself (for example, $.subscription_tier or $.shipping_address.city).
  • The detected data type (string, number, boolean, date, or array).
  • An auto-assigned visibility of public.
New paths appear after the schema sync runs. Admins can then review their visibility.

​
Visibility levels

Public is the default for newly discovered paths. Visibility controls the rule-path catalogue and filtered contact API responses; it is not a template privacy boundary. Avoid placing sensitive data in contact attributes used by templates.

​
Set visibility on an attribute

1

Open Settings → Data Schema

Inside the project, open Settings and pick the Data Schema tab. The table lists every contact attribute Spotzee has observed.
2

Pick an attribute

Click a row to open the visibility editor for that path. The path appears at the top of the drawer in monospace.
3

Choose visibility

Pick Public, Hidden, or Classified. Choose Save to apply the visibility change.

​
Data types

The detected data_type decides which segment operators are available for that path. The mapping comes straight from the rules engine: Spotzee records the type seen when a path is first discovered. If the inference is wrong (a field that’s typed as a number in your source becomes a string in segments because the first values came in quoted), correct the type at the source. You can’t override the type in the UI; it’s a function of the actual data. For the full operator reference and how rules combine into segments, see Build segments.

​
Schema refresh

Spotzee runs a schema sync every hour over recently updated contacts and events. Use Rebuild under Settings → General → Advanced to queue a full schema sync when you need to reconcile the index with stored records. A full sync removes paths no longer present and keeps visibility on paths that remain.

​
Next steps

Build segments

Use your typed attributes in segment rules.

Sync contacts

Push attribute data into the project via the API.

Ingest events

Send events with payload attributes that land in the schema.

Build templates

Use template variables to render attribute values into your messages.