---
title: Subscription Lexicon
description: Schema reference for subscriptions, used to tracks relationships between users and publications.
date: 2026-02-10
atUri: "at://did:plc:re3ebnp5v7ffagz6rb6xfei4/site.standard.document/3mek5jhupfh2p"
ogImage: opengraph-image-docs-subscription-lexicon-v2.png
---

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

# Subscription Lexicon

The `site.standard.graph.subscription` lexicon tracks relationships between users and publications.

## Overview

Subscriptions enable users to follow publications and receive updates about new content. They represent the social connection between readers and the publications they're interested in.

## Schema

### Required Properties

<Table
    headers={['Property', 'Type', 'Description']}
    rows={[
        ['publication', 'at-uri', 'AT-URI reference to the publication record being subscribed to (ex: at://did:plc:abc123/site.standard.publication/xyz789)'],
    ]}
/>

### Optional Properties <Updated label="New" />

<Table
    headers={['Property', 'Type', 'Description']}
    rows={[
        ['createdAt', 'datetime', 'Timestamp marking when the subscription was created.'],
    ]}
/>

## Example <Updated />

```json
{
  "$type": "site.standard.graph.subscription",
  "publication": "at://did:plc:abc123/site.standard.publication/3lwafzkjqm25s",
  "createdAt": "2026-05-19T14:30:00.000Z"
}
```

## View the Lexicon

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

## Related

- [Publication lexicon](/docs/lexicons/publication) - Publications that can be subscribed to
- [Document lexicon](/docs/lexicons/document) - Content from subscribed publications
- [Quick Start](/docs/quick-start) - Implementation guide
