# pub.byline.book

> Published by [bylinepub.bsky.social](https://lexicon.garden/identity/did:plc:ppjep63wzgs57unhrdcxqttm)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:ppjep63wzgs57unhrdcxqttm/pub.byline.book)
- [Documentation](https://lexicon.garden/lexicon/did:plc:ppjep63wzgs57unhrdcxqttm/pub.byline.book/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:ppjep63wzgs57unhrdcxqttm/pub.byline.book/examples)

## Definitions

### `pub.byline.book`

**Type**: `record`

An author-authoritative record of a published or forthcoming work, signed by the author's own repository.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `tags` | `array` | No | Freeform descriptors. Genre lives in genres[]; tags are everything else. |
| `cover` | `blob` | No | Cover image, stored as a blob in the author's own repository. |
| `links` | `array` | No | Work-level links not tied to a specific edition. |
| `title` | `string` | Yes |  |
| `genres` | `array` | No | Shelf-category genres for the work. Freeform; byline's authoring tool suggests existing values to encourage convergence, but no value is enforced. |
| `series` | `ref` → `lex:pub.byline.defs#seriesMembership` | No | Series membership, if any. Book points at the series; the series record never points back. |
| `status` | `string` | No |  |
| `authors` | `array` | No | Credited contributors. The repo owner is presumed primary author unless roles say otherwise. |
| `tagline` | `string` | No | One-line hook for hero or featured display. Plain text, no markdown. |
| `coverAlt` | `string` | No | Alt text describing the cover image, for accessibility. |
| `editions` | `array` | No |  |
| `language` | `string` | No | BCP-47 language tag, e.g. en, en-CA. |
| `subtitle` | `string` | No |  |
| `createdAt` | `string` (datetime) | Yes |  |
| `pageCount` | `integer` | No | Work-level page count. An edition's pageCount overrides this when present. |
| `publisher` | `string` | No | Work-level publisher. An edition's publisher overrides this when present. |
| `updatedAt` | `string` (datetime) | No |  |
| `description` | `string` | No | Long blurb / marketing copy. Markdown; consumers render or strip. |
| `discussions` | `array` | No | Strong references to atproto-native discussion threads about this work (e.g. a Bluesky post, a pub.byline.comment). Off-protocol social goes in links[] with kind=discussion or social. |
| `identifiers` | `ref` → `lex:pub.byline.defs#identifiers` | No |  |
| `copyrightYear` | `integer` | No | Year of first copyright for the work. |
| `publicationDate` | `string` (datetime) | No | Actual or planned first-publication date. |
| `shortDescription` | `string` | No | Card and grid summary. Markdown; consumers render or strip. |

## Raw Schema

```json
{
  "id": "pub.byline.book",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "title",
          "createdAt"
        ],
        "properties": {
          "tags": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 128,
              "maxGraphemes": 128
            },
            "description": "Freeform descriptors. Genre lives in genres[]; tags are everything else."
          },
          "cover": {
            "type": "blob",
            "accept": [
              "image/png",
              "image/jpeg",
              "image/webp"
            ],
            "maxSize": 2000000,
            "description": "Cover image, stored as a blob in the author's own repository."
          },
          "links": {
            "type": "array",
            "items": {
              "ref": "lex:pub.byline.defs#link",
              "type": "ref"
            },
            "description": "Work-level links not tied to a specific edition."
          },
          "title": {
            "type": "string",
            "maxLength": 512,
            "minLength": 1
          },
          "genres": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 128,
              "maxGraphemes": 128
            },
            "description": "Shelf-category genres for the work. Freeform; byline's authoring tool suggests existing values to encourage convergence, but no value is enforced."
          },
          "series": {
            "ref": "lex:pub.byline.defs#seriesMembership",
            "type": "ref",
            "description": "Series membership, if any. Book points at the series; the series record never points back."
          },
          "status": {
            "type": "string",
            "knownValues": [
              "pub.byline.defs#published",
              "pub.byline.defs#forthcoming",
              "pub.byline.defs#draft",
              "pub.byline.defs#outOfPrint"
            ]
          },
          "authors": {
            "type": "array",
            "items": {
              "ref": "lex:pub.byline.defs#contributor",
              "type": "ref"
            },
            "description": "Credited contributors. The repo owner is presumed primary author unless roles say otherwise."
          },
          "tagline": {
            "type": "string",
            "description": "One-line hook for hero or featured display. Plain text, no markdown.",
            "maxGraphemes": 200
          },
          "coverAlt": {
            "type": "string",
            "maxLength": 1000,
            "description": "Alt text describing the cover image, for accessibility."
          },
          "editions": {
            "type": "array",
            "items": {
              "ref": "lex:pub.byline.defs#edition",
              "type": "ref"
            }
          },
          "language": {
            "type": "string",
            "description": "BCP-47 language tag, e.g. en, en-CA."
          },
          "subtitle": {
            "type": "string",
            "maxLength": 512
          },
          "createdAt": {
            "type": "string",
            "format": "datetime"
          },
          "pageCount": {
            "type": "integer",
            "minimum": 1,
            "description": "Work-level page count. An edition's pageCount overrides this when present."
          },
          "publisher": {
            "type": "string",
            "maxLength": 256,
            "description": "Work-level publisher. An edition's publisher overrides this when present."
          },
          "updatedAt": {
            "type": "string",
            "format": "datetime"
          },
          "description": {
            "type": "string",
            "description": "Long blurb / marketing copy. Markdown; consumers render or strip.",
            "maxGraphemes": 5000
          },
          "discussions": {
            "type": "array",
            "items": {
              "ref": "lex:com.atproto.repo.strongRef",
              "type": "ref"
            },
            "description": "Strong references to atproto-native discussion threads about this work (e.g. a Bluesky post, a pub.byline.comment). Off-protocol social goes in links[] with kind=discussion or social."
          },
          "identifiers": {
            "ref": "lex:pub.byline.defs#identifiers",
            "type": "ref"
          },
          "copyrightYear": {
            "type": "integer",
            "description": "Year of first copyright for the work."
          },
          "publicationDate": {
            "type": "string",
            "format": "datetime",
            "description": "Actual or planned first-publication date."
          },
          "shortDescription": {
            "type": "string",
            "description": "Card and grid summary. Markdown; consumers render or strip.",
            "maxGraphemes": 500
          }
        }
      },
      "description": "An author-authoritative record of a published or forthcoming work, signed by the author's own repository."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```