# app.zeens.featuredItem

> Published by [zeens.app](https://lexicon.garden/identity/did:plc:pwpuqwge6g7xrjmfbw73uycw)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:pwpuqwge6g7xrjmfbw73uycw/app.zeens.featuredItem)
- [Documentation](https://lexicon.garden/lexicon/did:plc:pwpuqwge6g7xrjmfbw73uycw/app.zeens.featuredItem/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:pwpuqwge6g7xrjmfbw73uycw/app.zeens.featuredItem/examples)

## Definitions

### `app.zeens.featuredItem`

**Type**: `record`

An admin-curated featured item, written to the dedicated curator repo (feeder.psky.social). Currently always a post; `kind` future-proofs featured collections. `active=false` pulls the item from the splash carousel but keeps it for the Inspire > Featured archive. Reorder = putRecord with a new `position`; unfeature = putRecord with active=false; hard-remove = deleteRecord.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `active` | `boolean` | Yes | True = shown in the splash carousel. False = retired but kept for the Featured archive. |
| `app.zeens.v` | `integer` | No |  |
| `createdAt` | `string` (datetime) | Yes |  |
| `kind` | `string` | Yes | What the subject is. Only `post` is used today. |
| `layout` | `string` | No | Tile size in the public Featured grid: square (1x1), wide (2x1), or tall (1x2). Absent = square. |
| `position` | `integer` | Yes | Admin sort order within the active set (lower = earlier). |
| `subject` | `ref` → `com.atproto.repo.strongRef` | Yes | Strong-ref to the featured post (or, later, collection). |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "An admin-curated featured item, written to the dedicated curator repo (feeder.psky.social). Currently always a post; `kind` future-proofs featured collections. `active=false` pulls the item from the splash carousel but keeps it for the Inspire > Featured archive. Reorder = putRecord with a new `position`; unfeature = putRecord with active=false; hard-remove = deleteRecord.",
      "key": "tid",
      "record": {
        "properties": {
          "active": {
            "description": "True = shown in the splash carousel. False = retired but kept for the Featured archive.",
            "type": "boolean"
          },
          "app.zeens.v": {
            "type": "integer"
          },
          "createdAt": {
            "format": "datetime",
            "type": "string"
          },
          "kind": {
            "description": "What the subject is. Only `post` is used today.",
            "enum": [
              "post",
              "collection"
            ],
            "type": "string"
          },
          "layout": {
            "description": "Tile size in the public Featured grid: square (1x1), wide (2x1), or tall (1x2). Absent = square.",
            "enum": [
              "square",
              "wide",
              "tall"
            ],
            "type": "string"
          },
          "position": {
            "description": "Admin sort order within the active set (lower = earlier).",
            "type": "integer"
          },
          "subject": {
            "description": "Strong-ref to the featured post (or, later, collection).",
            "ref": "com.atproto.repo.strongRef",
            "type": "ref"
          }
        },
        "required": [
          "subject",
          "kind",
          "position",
          "active",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "id": "app.zeens.featuredItem",
  "lexicon": 1
}
```