social.showcase.collection.collection

lexicons.showcase.social

Documentation

Collection record

main record

Collection record

Record Key tid Timestamp-based ID

Properties

coverImage blob Optional

Optional custom cover image (1600x900px max, auto-generated if not provided)

maxSize: 5.0 MB
createdAt string datetime Required

An RFC 3339 formatted timestamp.

description string Optional

Collection description

maxLength: 1000 bytes
name string Required

Collection name

maxLength: 200 bytes
notes string Optional

Personal notes about the collection

maxLength: 2000 bytes
schemaVersion integer Optional

Schema version for migrations (defaults to 1 if missing)

Default: 1
tags array of string Required

Tags for discovery (max 10)

maxLength: 10 items
type string Required

Collection type: 'custom' = regular collection (user's owned items only), 'bookmark' = bookmark collection (can include other users' items as references)

maxLength: 20 bytes
Known values: custom, bookmark
updatedAt string datetime Optional

An RFC 3339 formatted timestamp.

visibility string Required

No description available.

maxLength: 10 bytes
Known values: public, private
View raw schema
{
  "key": "tid",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "name",
      "tags",
      "type",
      "items",
      "visibility",
      "createdAt"
    ],
    "properties": {
      "name": {
        "type": "string",
        "maxLength": 200,
        "description": "Collection name"
      },
      "tags": {
        "type": "array",
        "items": {
          "type": "string",
          "maxLength": 64
        },
        "maxLength": 10,
        "description": "Tags for discovery (max 10)"
      },
      "type": {
        "type": "string",
        "maxLength": 20,
        "description": "Collection type: 'custom' = regular collection (user's owned items only), 'bookmark' = bookmark collection (can include other users' items as references)",
        "knownValues": [
          "custom",
          "bookmark"
        ]
      },
      "items": {
        "type": "array",
        "items": {
          "ref": "social.showcase.defs#collectionItem",
          "type": "ref"
        },
        "maxLength": 500,
        "description": "Ordered list of items (max 500)"
      },
      "notes": {
        "type": "string",
        "maxLength": 2000,
        "description": "Personal notes about the collection"
      },
      "createdAt": {
        "type": "string",
        "format": "datetime"
      },
      "updatedAt": {
        "type": "string",
        "format": "datetime"
      },
      "coverImage": {
        "type": "blob",
        "accept": [
          "image/png",
          "image/jpeg",
          "image/webp"
        ],
        "maxSize": 5000000,
        "description": "Optional custom cover image (1600x900px max, auto-generated if not provided)"
      },
      "visibility": {
        "type": "string",
        "maxLength": 10,
        "knownValues": [
          "public",
          "private"
        ]
      },
      "description": {
        "type": "string",
        "maxLength": 1000,
        "description": "Collection description"
      },
      "schemaVersion": {
        "type": "integer",
        "default": 1,
        "description": "Schema version for migrations (defaults to 1 if missing)"
      }
    }
  },
  "description": "Collection record"
}

Lexicon Garden

@