# app.zeens.collectionItem

> 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.collectionItem)
- [Documentation](https://lexicon.garden/lexicon/did:plc:pwpuqwge6g7xrjmfbw73uycw/app.zeens.collectionItem/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:pwpuqwge6g7xrjmfbw73uycw/app.zeens.collectionItem/examples)

## Definitions

### `app.zeens.collectionItem`

**Type**: `record`

A single item (post or article) inside a Zeens collection. The collection itself is referenced by its AT-URI. Removing an item is a record delete. Re-adding the same subject creates a new item record (clients should de-dupe by subject.uri at write time if needed).

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `addedAt` | `string` (datetime) | Yes |  |
| `app.zeens.v` | `integer` | No |  |
| `collection` | `string` (at-uri) | Yes | AT-URI of the parent app.zeens.collection record. |
| `images` | `array` | No | Post subjects only: the 0-based positions of the post's photos this item keeps, for someone filing only some photos of a multi-photo post. Absent means every photo. A selection naming none of the post's photos is treated as absent. |
| `note` | `string` | No | Optional note from the curator about why they added this item. |
| `subject` | `ref` → `com.atproto.repo.strongRef` | Yes | Strong-ref to the post or article being collected. Subject can be any AT-URI; the AppView resolves what to render based on the URI's collection (app.bsky.feed.post or app.zeens.article). |
| `submission` | `ref` → `com.atproto.repo.strongRef` | No | Community collections only: the photographer's own collectionItem this item approves. While it is set, the item is shown only as long as that submission exists, so deleting the submission withdraws the photo. |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "A single item (post or article) inside a Zeens collection. The collection itself is referenced by its AT-URI. Removing an item is a record delete. Re-adding the same subject creates a new item record (clients should de-dupe by subject.uri at write time if needed).",
      "key": "tid",
      "record": {
        "properties": {
          "addedAt": {
            "format": "datetime",
            "type": "string"
          },
          "app.zeens.v": {
            "type": "integer"
          },
          "collection": {
            "description": "AT-URI of the parent app.zeens.collection record.",
            "format": "at-uri",
            "type": "string"
          },
          "images": {
            "description": "Post subjects only: the 0-based positions of the post's photos this item keeps, for someone filing only some photos of a multi-photo post. Absent means every photo. A selection naming none of the post's photos is treated as absent.",
            "items": {
              "minimum": 0,
              "type": "integer"
            },
            "type": "array"
          },
          "note": {
            "description": "Optional note from the curator about why they added this item.",
            "maxLength": 280,
            "type": "string"
          },
          "subject": {
            "description": "Strong-ref to the post or article being collected. Subject can be any AT-URI; the AppView resolves what to render based on the URI's collection (app.bsky.feed.post or app.zeens.article).",
            "ref": "com.atproto.repo.strongRef",
            "type": "ref"
          },
          "submission": {
            "description": "Community collections only: the photographer's own collectionItem this item approves. While it is set, the item is shown only as long as that submission exists, so deleting the submission withdraws the photo.",
            "ref": "com.atproto.repo.strongRef",
            "type": "ref"
          }
        },
        "required": [
          "collection",
          "subject",
          "addedAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "id": "app.zeens.collectionItem",
  "lexicon": 1
}
```