Introduction to Simple Metadata
Turn Confluence pages into structured, validated, reportable data.
GET STARTED
A data layer for Confluence pages
Simple Metadata lets administrators define schemas and lets authors capture structured values on individual Confluence pages. The same schema drives capture forms, validation, history and reports.
A compliance evidence layer
For compliance teams, a schema can represent a repeatable control or evidence record: control ID, scope, owner, status, evidence reference, approval and next review. Template the record once, then capture the same shape wherever the control is performed.
How it works
A schema defines fields, types, constraints, permissions and optional indexed fields. A capture macro stores one document for a page and schema. A report macro lists matching entries across the site.
- 1 Schemas are the source of truth
- 2 Entries are attached to pages
- 3 Indexed fields make reports filterable
The record behind the page
A schema is the source of truth for fields, types, constraints, permissions and indexed paths. An entry is one JSON document for one page and one schema; the capture form, validation state and reports all read that definition.
Live schemas and entries are stored in Forge SQL. Selectively indexed values support report filtering, while entry snapshots and schema revisions are retained separately for history.
Choose the right starting point
Use Simple Metadata when a page needs a governed, repeatable record rather than an informal two-column table. Start small: identify the owner, status, scope, evidence reference and next review date that readers need to compare.
- Define the schema once
- Place a capture macro where authors work
- Publish a report for cross-page review
A practical evidence workflow
A control owner needs a consistent record without moving work into another system.
- Before
- Each page uses a different table or free-form notes, so review status is hard to compare.
- With Simple Metadata
- A shared schema captures the same fields on every page and a report brings the entries together.
Result
Turn Confluence pages into structured, validated, reportable data.
Next step: Quick start