---
title: Publication Lexicon
description: Schema reference for publications, used to describe information about a particular publication.
date: 2026-02-10
atUri: "at://did:plc:re3ebnp5v7ffagz6rb6xfei4/site.standard.document/3mek5jhwhcv26"
ogImage: opengraph-image-docs-publication-lexicon-v2.png
---

import { Table, Updated } from '@/app/components/docs'

# Publication Lexicon

The `site.standard.publication` lexicon is used to describe information about a particular publication.

## Overview

A publication represents a collection of documents published to the web. It includes important information about a publication including its location on the web, theming information, user preferences, and more.

The publication lexicon is not a requirement, but is recommended when publishing collections of related documents.

## Schema

### Required Properties

<Table
    headers={['Property', 'Type', 'Description']}
    rows={[
        ['url', 'string', 'Base url for the publication. (ex: https://standard.site). This value will be combined with the document path to construct a full URL for the document. Avoid trailing slashes.'],
        ['name', 'string', <>Name of the publication. <code>maxLength: 5000</code> <code>maxGraphemes: 500</code></>],
    ]}
/>

### Optional Properties <Updated />

<Table
    headers={['Property', 'Type', 'Description']}
    rows={[
        ['icon', 'blob', 'Square image to identify the publication. Should be at least 256x256.'],
        ['description', 'string', <>Brief description of the publication. <code>maxLength: 30000</code> <code>maxGraphemes: 3000</code></>],
        ['basicTheme', 'ref', <>Simplified theme for tools and apps to utilize when displaying content. (ref → <a href="/docs/lexicons/theme">site.standard.theme.basic</a>)</>],
        ['labels', 'union', <>Self-label values for this publication. Effectively content warnings. (ref → <code>com.atproto.label.defs#selfLabels</code>)</>],
        ['preferences', 'object', 'Platform-specific preferences for the publication, including discovery and visibility settings.'],
        ['preferences.showInDiscover', 'boolean', 'Decides whether the publication should appear in discovery feeds.'],
    ]}
/>

## Example

```json
{
  "$type": "site.standard.publication",
  "url": "https://standard.site",
  "icon": {
    "$type": "blob",
    "ref": {
      "$link": "bafkreiexample123456789"
    },
    "mimeType": "image/png",
    "size": 12345
  },
  "name": "Standard.site Blog",
  "description": "Documentation and updates about Standard.site lexicons",
  "basicTheme": {
    "$type": "site.standard.theme.basic",
    "background": {
      "$type": "site.standard.theme.color#rgb",
      "r": 255,
      "g": 255,
      "b": 255
    },
    "foreground": {
      "$type": "site.standard.theme.color#rgb",
      "r": 31,
      "g": 41,
      "b": 55
    },
    "accent": {
      "$type": "site.standard.theme.color#rgb",
      "r": 59,
      "g": 130,
      "b": 246
    },
    "accentForeground": {
      "$type": "site.standard.theme.color#rgb",
      "r": 255,
      "g": 255,
      "b": 255
    }
  },
  "preferences": {
    "showInDiscover": true
  }
}
```

## View the Lexicon

- [View full lexicon schema](https://pdsls.dev/at://did:plc:re3ebnp5v7ffagz6rb6xfei4/com.atproto.lexicon.schema/site.standard.publication)
- [Example record](https://pdsls.dev/at://did:plc:revjuqmkvrw6fnkxppqtszpv/site.standard.publication/3lwafzkjqm25s)

## Extensibility

Lexicons are extendable. Additional properties may be added to better suit the needs of a project.

## Best Practices

- While we encourage avoid trailing slashes, some may not implement this in practice. If you are validating records, you should trim trailing slashes for `url` in your codebase.

## Related

- [Document lexicon](/docs/lexicons/document) - Individual documents within publications
- [Theme lexicon](/docs/lexicons/theme) - Publication theming
- [Verification](/docs/verification) - Link publications to a domain
- [Quick Start](/docs/quick-start) - Implementation guide
