---
title: Recommend Lexicon
description: Schema reference for document recommends, used to declare that a user endorses or recommends a document.
date: 2026-05-19
ogImage: opengraph-image-docs-recommend-lexicon-v2.png
---

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

# Recommend Lexicon <Updated label="New" />

The `site.standard.graph.recommend` lexicon declares that a user recommends a document.

## Overview

Recommends are lightweight social signals: a user creates a `recommend` record on their PDS pointing at a `site.standard.document` they endorse. Aggregators and readers can use these records to surface popular or trusted documents.

## Schema

### Required Properties

<Table
    headers={['Property', 'Type', 'Description']}
    rows={[
        ['document', 'at-uri', 'AT-URI reference to the document record being recommended (ex: at://did:plc:abc123/site.standard.document/xyz789).'],
        ['createdAt', 'datetime', 'Timestamp marking when the recommend was created.'],
    ]}
/>

## Example

```json
{
  "$type": "site.standard.graph.recommend",
  "document": "at://did:plc:abc123/site.standard.document/3mbfqhezge25u",
  "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.recommend)

## Related

- [Document lexicon](/docs/lexicons/document) - Documents that can be recommended
- [Subscription lexicon](/docs/lexicons/subscription) - Following whole publications
- [Permissions](/docs/permissions) - `site.standard.authSocial` grants access to recommend records
