# work.sequential.chapter

> Published by [sequential.work](https://lexicon.garden/identity/did:plc:tndzxgswtjuwylmsa5x3whwa)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:tndzxgswtjuwylmsa5x3whwa/work.sequential.chapter)
- [Documentation](https://lexicon.garden/lexicon/did:plc:tndzxgswtjuwylmsa5x3whwa/work.sequential.chapter/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:tndzxgswtjuwylmsa5x3whwa/work.sequential.chapter/examples)

## Definitions

### `work.sequential.chapter`

**Type**: `record`

A chapter in a series.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `covers` | `array` | Yes | Ordered list of work.sequential.cover records. The first is the primary cover; the rest are variants. Use the DID form (at://did:...), not a handle. |
| `createdAt` | `string` (datetime) | Yes | The date and time the chapter was published. Drafts are kept by the AppView and only written to the repo when published. |
| `credits` | `array` | No | The credits for the people who worked on this chapter. |
| `description` | `array` | No | Localized short description of the chapter. |
| `pages` | `array` | No | Ordered list of work.sequential.page records. Used when the series format is 'page'. Use the DID form (at://did:...), not a handle. |
| `series` | `string` (at-uri) | Yes | AT-URI of the parent series. Use the DID form (at://did:...), not a handle. |
| `slices` | `array` | No | Ordered list of work.sequential.slice records. Used when the series format is 'vertical'. Use the DID form (at://did:...), not a handle. |
| `status` | `string` | No | Publication status of the chapter. Use 'ongoing' while it is still being published, e.g. one page at a time. AppViews may define their own statuses. |
| `tags` | `array` | No | Free-form tags for this chapter. |
| `title` | `array` | No | Localized chapter title or number. |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "A chapter in a series.",
      "key": "tid",
      "record": {
        "properties": {
          "covers": {
            "description": "Ordered list of work.sequential.cover records. The first is the primary cover; the rest are variants. Use the DID form (at://did:...), not a handle.",
            "items": {
              "format": "at-uri",
              "type": "string"
            },
            "maxLength": 500,
            "minLength": 1,
            "type": "array"
          },
          "createdAt": {
            "description": "The date and time the chapter was published. Drafts are kept by the AppView and only written to the repo when published.",
            "format": "datetime",
            "type": "string"
          },
          "credits": {
            "description": "The credits for the people who worked on this chapter.",
            "items": {
              "ref": "work.sequential.defs#credit",
              "type": "ref"
            },
            "maxLength": 100,
            "type": "array"
          },
          "description": {
            "description": "Localized short description of the chapter.",
            "items": {
              "ref": "work.sequential.defs#localizedDescription",
              "type": "ref"
            },
            "maxLength": 100,
            "type": "array"
          },
          "pages": {
            "description": "Ordered list of work.sequential.page records. Used when the series format is 'page'. Use the DID form (at://did:...), not a handle.",
            "items": {
              "format": "at-uri",
              "type": "string"
            },
            "maxLength": 1000,
            "type": "array"
          },
          "series": {
            "description": "AT-URI of the parent series. Use the DID form (at://did:...), not a handle.",
            "format": "at-uri",
            "type": "string"
          },
          "slices": {
            "description": "Ordered list of work.sequential.slice records. Used when the series format is 'vertical'. Use the DID form (at://did:...), not a handle.",
            "items": {
              "format": "at-uri",
              "type": "string"
            },
            "maxLength": 1000,
            "type": "array"
          },
          "status": {
            "default": "completed",
            "description": "Publication status of the chapter. Use 'ongoing' while it is still being published, e.g. one page at a time. AppViews may define their own statuses.",
            "knownValues": [
              "ongoing",
              "completed",
              "hiatus",
              "cancelled"
            ],
            "type": "string"
          },
          "tags": {
            "description": "Free-form tags for this chapter.",
            "items": {
              "ref": "work.sequential.defs#tag",
              "type": "ref"
            },
            "maxLength": 10,
            "type": "array"
          },
          "title": {
            "description": "Localized chapter title or number.",
            "items": {
              "ref": "work.sequential.defs#localizedTitle",
              "type": "ref"
            },
            "maxLength": 100,
            "type": "array"
          }
        },
        "required": [
          "series",
          "createdAt",
          "covers"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "id": "work.sequential.chapter",
  "lexicon": 1
}
```