# community.lexicon.media.book.edition

> Optional repository publication of an edition. Its fields mirror defs#edition; publishing a catalog on AT Protocol is not required.

- Kind: record
- Record key: tid
- Authority: book.media.lexicon.community
- Lexicon: 1
- Published by [lexicons.lexicon.community](https://lexicon.garden/identity/did:plc:mtr7qrqtcyseedx3jyr5o7db), the NSID's authority

## Links

- [Documentation](https://lexicon.garden/lexicon/did:plc:mtr7qrqtcyseedx3jyr5o7db/community.lexicon.media.book.edition)
- [Schema JSON](https://lexicon.garden/lexicon/did:plc:mtr7qrqtcyseedx3jyr5o7db/community.lexicon.media.book.edition/schema.json)
- [Analytics](https://lexicon.garden/lexicon/did:plc:mtr7qrqtcyseedx3jyr5o7db/community.lexicon.media.book.edition/analytics)

## Record (`community.lexicon.media.book.edition`)

Type: record · key tid

### Properties

- `bookEdition` (string): Edition statement, such as 2nd revised or Abridged.
- `chapters` (integer): Total chapter count, when known. This is an extent, not the reader's progress or a table of contents.
  - Constraints: minimum: 0
- `contributors` (array, required): Contributors credited on the edition. May be empty for anonymous or unknown contributions.
  - `items` (ref)
    - Reference: `community.lexicon.media.book.defs#contributor`
- `cover` (blob): Optional cover image, strongly recommended when storing in a repository. The blob must belong to the repository containing the record, including when embedded in a review. May coexist with coverUrl.
  - Constraints: accept: image/*
- `coverUrl` (string · uri): Optional cover image URL, useful for API responses and providers without repository storage. May coexist with cover; a URL alone does not preserve image bytes in the user's repository.
- `createdAt` (string · datetime, required): Time this edition record or snapshot was created, not its publication date.
- `description` (string): Description of the edition.
- `durationSeconds` (integer): Total audio duration in whole seconds, when known.
  - Constraints: minimum: 0
- `format` (string): Medium of the edition. Additional values are permitted; clients should provide a fallback for unrecognized formats.
  - Constraints: knownValues: physical | ebook | audio
- `identifiers` (array, required): Known identifiers for this edition, including provider grouping identifiers. Include the writing provider's identifier where available.
  - Constraints: minLength: 1
  - `items` (ref)
    - Reference: `community.lexicon.media.book.defs#identifier`
- `language` (string · language): Language of the edition as a BCP 47 language tag.
- `pages` (integer): Total page count for print or ebook editions, when known.
  - Constraints: minimum: 0
- `publishedDate` (string): Publication date in ISO 8601 format at its known precision: YYYY, YYYY-MM, or YYYY-MM-DD. Preserve available precision without inventing a month or day. Applications must validate the date; this is not a datetime.
  - Constraints: minLength: 4, maxLength: 10
- `publisher` (ref)
  - Reference: `community.lexicon.media.book.defs#publisher`
- `series` (ref)
  - Reference: `community.lexicon.media.book.defs#series`
- `subtitle` (string): Subtitle of the edition.
- `title` (string, required): Title of the edition.
  - Constraints: minLength: 1

## Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "Optional repository publication of an edition. Its fields mirror defs#edition; publishing a catalog on AT Protocol is not required.",
      "key": "tid",
      "record": {
        "description": "Full edition metadata for books, including comic books and graphic novels, for embedding and optional repository publication. Provider APIs use editionView, which carries covers as URLs only.",
        "properties": {
          "bookEdition": {
            "description": "Edition statement, such as 2nd revised or Abridged.",
            "type": "string"
          },
          "chapters": {
            "description": "Total chapter count, when known. This is an extent, not the reader's progress or a table of contents.",
            "minimum": 0,
            "type": "integer"
          },
          "contributors": {
            "description": "Contributors credited on the edition. May be empty for anonymous or unknown contributions.",
            "items": {
              "ref": "community.lexicon.media.book.defs#contributor",
              "type": "ref"
            },
            "type": "array"
          },
          "cover": {
            "accept": [
              "image/*"
            ],
            "description": "Optional cover image, strongly recommended when storing in a repository. The blob must belong to the repository containing the record, including when embedded in a review. May coexist with coverUrl.",
            "type": "blob"
          },
          "coverUrl": {
            "description": "Optional cover image URL, useful for API responses and providers without repository storage. May coexist with cover; a URL alone does not preserve image bytes in the user's repository.",
            "format": "uri",
            "type": "string"
          },
          "createdAt": {
            "description": "Time this edition record or snapshot was created, not its publication date.",
            "format": "datetime",
            "type": "string"
          },
          "description": {
            "description": "Description of the edition.",
            "type": "string"
          },
          "durationSeconds": {
            "description": "Total audio duration in whole seconds, when known.",
            "minimum": 0,
            "type": "integer"
          },
          "format": {
            "description": "Medium of the edition. Additional values are permitted; clients should provide a fallback for unrecognized formats.",
            "knownValues": [
              "physical",
              "ebook",
              "audio"
            ],
            "type": "string"
          },
          "identifiers": {
            "description": "Known identifiers for this edition, including provider grouping identifiers. Include the writing provider's identifier where available.",
            "items": {
              "ref": "community.lexicon.media.book.defs#identifier",
              "type": "ref"
            },
            "minLength": 1,
            "type": "array"
          },
          "language": {
            "description": "Language of the edition as a BCP 47 language tag.",
            "format": "language",
            "type": "string"
          },
          "pages": {
            "description": "Total page count for print or ebook editions, when known.",
            "minimum": 0,
            "type": "integer"
          },
          "publishedDate": {
            "description": "Publication date in ISO 8601 format at its known precision: YYYY, YYYY-MM, or YYYY-MM-DD. Preserve available precision without inventing a month or day. Applications must validate the date; this is not a datetime.",
            "maxLength": 10,
            "minLength": 4,
            "type": "string"
          },
          "publisher": {
            "ref": "community.lexicon.media.book.defs#publisher",
            "type": "ref"
          },
          "series": {
            "ref": "community.lexicon.media.book.defs#series",
            "type": "ref"
          },
          "subtitle": {
            "description": "Subtitle of the edition.",
            "type": "string"
          },
          "title": {
            "description": "Title of the edition.",
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "title",
          "identifiers",
          "contributors",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "description": "A specific published instance of a book, including comic books and graphic novels, such as one printing, translation, or audiobook production. Not a work: distinct editions of the same underlying text are distinct records. New metadata fields should follow the corresponding names, meaning, and shape in https://schema.org/Book, including inherited properties; document any adaptations or extensions.",
  "id": "community.lexicon.media.book.edition",
  "lexicon": 1
}
```
