<!-- https://developers.silktide.com/v1/governance/metadata | Governance -->

# Metadata

Metadata lets you record facts of your own about each website and section, to track them beside its results: who owns it, which region or department it belongs to, the year it launched.

## Properties

A metadata property is one such field. Properties are defined once for the whole account, and each website and section can hold a value for each of them. Account administrators define them on the Metadata settings screen in Silktide; if you cannot find it, ask Silktide to set them up for you. The API reads them but does not create them.

Each property has a `name`, which is the key its values are read and set by, and a `label`, which is what people see. It holds one type of value:

| `propertyType` | Holds                   |
| -------------- | ----------------------- |
| `string`       | Text.                   |
| `int`          | A whole number.         |
| `float`        | A decimal number.       |
| `bool`         | `true` or `false`.      |
| `url`          | A web address, as text. |

A property can also be required, have a smallest and largest value (or length, for text), and offer a list of `choices`, with or without allowing other values. These are guidance for the forms people fill in: the API saves a value without checking it against them.

## Values

Read a section's values with [Get a section's metadata](https://developers.silktide.com/v1/governance/metadata/get-section-metadata.md), and change them with [Set a section's metadata](https://developers.silktide.com/v1/governance/metadata/set-section-metadata.md). Section `0` is the whole website; see [Websites and sections](https://developers.silktide.com/v1/concepts/websites-and-sections.md). You can also give a new website its values when you [create it](https://developers.silktide.com/v1/governance/websites/create-website.md).

In Silktide itself: [Metadata screen](https://docs.silktide.com/settings/screens/metadata), in Help.
## Operations

- [Get a section's metadata, and the properties it can have](https://developers.silktide.com/v1/governance/metadata/get-section-metadata.md): `GET /v1/websites/{websiteId}/sections/{sectionId}/meta`
- [Set some of a section's metadata](https://developers.silktide.com/v1/governance/metadata/set-section-metadata.md): `POST /v1/websites/{websiteId}/sections/{sectionId}/meta`
