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 MBcreatedAt
string
datetime
Required
An RFC 3339 formatted timestamp.
description
string
Optional
Collection description
maxLength: 1000 bytesitems
array
of
ref
social.showcase.defs#collectionItem
Required
Ordered list of items (max 500)
maxLength: 500 itemsname
string
Required
Collection name
maxLength: 200 bytesnotes
string
Optional
Personal notes about the collection
maxLength: 2000 bytesschemaVersion
integer
Optional
Schema version for migrations (defaults to 1 if missing)
Default:
1tags
array
of
string
Required
Tags for discovery (max 10)
maxLength: 10 itemstype
string
Required
Collection type: 'custom' = regular collection (user's owned items only), 'bookmark' = bookmark collection (can include other users' items as references)
maxLength: 20 bytesKnown values:
custom, bookmarkupdatedAt
string
datetime
Optional
An RFC 3339 formatted timestamp.
visibility
string
Required
No description available.
maxLength: 10 bytesKnown values:
public, privateView 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"
}