# coop.hypha.spores.site.section

> Published by [hypha.coop](https://lexicon.garden/identity/did:plc:rxduhzsfgfpl2glle7vagcwl)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:rxduhzsfgfpl2glle7vagcwl/coop.hypha.spores.site.section)
- [Documentation](https://lexicon.garden/lexicon/did:plc:rxduhzsfgfpl2glle7vagcwl/coop.hypha.spores.site.section/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:rxduhzsfgfpl2glle7vagcwl/coop.hypha.spores.site.section/examples)

## Definitions

### `coop.hypha.spores.site.section`

**Type**: `record`

A single site section for spores.garden. Each section is a record in a collection.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `ref` | `string` (at-uri) | No | AT-URI of the referenced record (for content/profile sections) |
| `rkey` | `string` | No | Record key within the collection to display (e.g. 'self' for profile) |
| `type` | `string` | Yes | Section type |
| `limit` | `integer` | No | Maximum records to display |
| `title` | `string` | No | Section title |
| `format` | `string` | No | Content format |
| `layout` | `string` | No | Layout to use for rendering |
| `content` | `string` | No | Content for block sections |
| `records` | `array` | No | Specific record URIs to display (for type=records) |
| `collection` | `string` | No | Collection NSID to display (for type=collection) |
| `hideHeader` | `boolean` | No | If true, hides the section header in display mode |

## Raw Schema

```json
{
  "id": "coop.hypha.spores.site.section",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "type"
        ],
        "properties": {
          "ref": {
            "type": "string",
            "format": "at-uri",
            "description": "AT-URI of the referenced record (for content/profile sections)"
          },
          "rkey": {
            "type": "string",
            "description": "Record key within the collection to display (e.g. 'self' for profile)"
          },
          "type": {
            "type": "string",
            "description": "Section type",
            "knownValues": [
              "collection",
              "records",
              "content",
              "block",
              "profile",
              "share-to-bluesky",
              "collected-flowers"
            ]
          },
          "limit": {
            "type": "integer",
            "maximum": 100,
            "minimum": 1,
            "description": "Maximum records to display"
          },
          "title": {
            "type": "string",
            "maxLength": 2000,
            "description": "Section title",
            "maxGraphemes": 200
          },
          "format": {
            "type": "string",
            "description": "Content format",
            "knownValues": [
              "markdown",
              "html",
              "text"
            ]
          },
          "layout": {
            "type": "string",
            "description": "Layout to use for rendering",
            "knownValues": [
              "post",
              "card",
              "image",
              "link",
              "links",
              "list",
              "profile",
              "raw"
            ]
          },
          "content": {
            "type": "string",
            "maxLength": 500000,
            "description": "Content for block sections",
            "maxGraphemes": 50000
          },
          "records": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "at-uri"
            },
            "description": "Specific record URIs to display (for type=records)"
          },
          "collection": {
            "type": "string",
            "description": "Collection NSID to display (for type=collection)"
          },
          "hideHeader": {
            "type": "boolean",
            "description": "If true, hides the section header in display mode"
          }
        }
      },
      "description": "A single site section for spores.garden. Each section is a record in a collection."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```