# app.bivri.feed.artwork

> Published by [lexicons.bivri.app](https://lexicon.garden/identity/did:plc:uqat5a7hrbww3snbbinxgwah)

✓ This is the authoritative definition for this NSID.

## Description

Record containing a Bivri artwork: one or more images published together under a single title.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:uqat5a7hrbww3snbbinxgwah/app.bivri.feed.artwork)
- [Documentation](https://lexicon.garden/lexicon/did:plc:uqat5a7hrbww3snbbinxgwah/app.bivri.feed.artwork/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:uqat5a7hrbww3snbbinxgwah/app.bivri.feed.artwork/examples)

## Definitions

### `app.bivri.feed.artwork`

**Type**: `record`

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `tags` | `array` | No | Author-chosen tags used for discovery and search. |
| `langs` | `array` | No | Human languages of the artwork's title and description. |
| `media` | `array` | Yes | Images making up the artwork, in display order. At least one is required. |
| `title` | `string` | Yes | Title of the artwork. |
| `labels` | `union` | No | Self-label values the author declared on this artwork, such as a spoiler warning. These are author metadata, not platform moderation decisions. |
| `createdAt` | `string` (datetime) | Yes | Client-declared timestamp of when the artwork was published. |
| `updatedAt` | `string` (datetime) | No | Client-declared timestamp of the last edit to this record. |
| `description` | `string` | No | Free-form description of the artwork. |

### `app.bivri.feed.artwork#mediaItem`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `alt` | `string` | Yes | Alternative text describing the image for members who cannot see it. |
| `blob` | `blob` | Yes | Image blob for this item. The write methods accept these three types and no others. |
| `aspectRatio` | `ref` → `app.bivri.feed.defs#aspectRatio` | No |  |

## Raw Schema

```json
{
  "id": "app.bivri.feed.artwork",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "title",
          "media",
          "createdAt"
        ],
        "properties": {
          "tags": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 640,
              "minLength": 1,
              "maxGraphemes": 64
            },
            "maxLength": 8,
            "description": "Author-chosen tags used for discovery and search."
          },
          "langs": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "language"
            },
            "maxLength": 3,
            "description": "Human languages of the artwork's title and description."
          },
          "media": {
            "type": "array",
            "items": {
              "ref": "#mediaItem",
              "type": "ref"
            },
            "maxLength": 50,
            "minLength": 1,
            "description": "Images making up the artwork, in display order. At least one is required."
          },
          "title": {
            "type": "string",
            "maxLength": 500,
            "minLength": 1,
            "description": "Title of the artwork.",
            "maxGraphemes": 50
          },
          "labels": {
            "refs": [
              "com.atproto.label.defs#selfLabels"
            ],
            "type": "union",
            "description": "Self-label values the author declared on this artwork, such as a spoiler warning. These are author metadata, not platform moderation decisions."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "Client-declared timestamp of when the artwork was published."
          },
          "updatedAt": {
            "type": "string",
            "format": "datetime",
            "description": "Client-declared timestamp of the last edit to this record."
          },
          "description": {
            "type": "string",
            "maxLength": 3000,
            "description": "Free-form description of the artwork.",
            "maxGraphemes": 300
          }
        }
      }
    },
    "mediaItem": {
      "type": "object",
      "required": [
        "blob",
        "alt"
      ],
      "properties": {
        "alt": {
          "type": "string",
          "description": "Alternative text describing the image for members who cannot see it."
        },
        "blob": {
          "type": "blob",
          "accept": [
            "image/jpeg",
            "image/png",
            "image/gif"
          ],
          "maxSize": 50000000,
          "description": "Image blob for this item. The write methods accept these three types and no others."
        },
        "aspectRatio": {
          "ref": "app.bivri.feed.defs#aspectRatio",
          "type": "ref"
        }
      }
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1,
  "description": "Record containing a Bivri artwork: one or more images published together under a single title."
}
```