> ## Documentation Index
> Fetch the complete documentation index at: https://flatfileinc-remove-rss-json.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Sheet Options

> configurable properties for a Sheet

<ParamField path="name" type="string" required>
  The name of your Sheet as it will appear to your end users.
</ParamField>

<ParamField path="description" type="string">
  A sentence or two describing the purpose of your Sheet.
</ParamField>

<ParamField path="slug" type="string">
  A unique identifier for your Sheet. Used to reference your Sheet in code, for
  example in a [Record Hook](/learning-center/guides/handling-data#example).
</ParamField>

<ParamField path="readonly" type="boolean">
  A boolean specifying whether or not this sheet is read only. Read only sheets
  are not editable by end users.
</ParamField>

<ParamField path="allowAdditionalFields" type="boolean">
  When this is set to `true`, your Sheet will be able to accept additional
  fields beyond what you specify in its configuration. These additional fields
  can be added via API, or by end users during the file import process. These
  fields will have a `treatment` of "user-defined".
</ParamField>

<ParamField path="access" type="array">
  An array specifying the access controls for this Sheet. [Read more about
  access controls](/learning-center/blueprint/access).
</ParamField>

<ParamField path="fields" type="array" required>
  This is where you define your Sheet's data schema. The collection of fields in
  your Sheet determines the shape of data you wish to accept.

  {""}

  Learn more about [Field types](/learning-center/blueprint/field-types), [Constraints](/learning-center/blueprint/constraints),
  and [Relationships](/learning-center/blueprint/relationships).
</ParamField>

<ParamField path="actions" type="array">
  An array of actions that end users can perform on this Sheet. [Read more about
  actions](/learning-center/concepts/actions).
</ParamField>

<ParamField path="metadata" type="object">
  Use `metadata` to store any extra contextual information about your Sheet.
  Must be valid JSON. This metadata can be updated at any time through the workbook update endpoint by including the metadata field in the sheet configuration.
</ParamField>

<ParamField path="mappingConfidenceThreshold" default=".5" type="number" id="mappingConfidenceThreshold">
  Use `mappingConfidenceThreshold` to configure the minimum required confidence
  for mapping jobs targeting that sheet. This can be used to tune the behavior
  of fuzzy matches, or disable fuzzy matches entirely. **Must be greater than 0
  and less than or equal to 1 (exact match)**
</ParamField>

<ParamField path="constraints" type="array">
  Use the `constraints` option to define constraints for a specific Sheet.
  Learn more about [Constraints](/learning-center/blueprint/constraints).
</ParamField>