Custom Metatags
Override auto-generated meta tags and JSON-LD for any paper using the editor sidebar.
Where to Find It
- Open any paper in the Editor.
- Click the Metadata tab in the right sidebar.
- You see a form with all metadata fields pre-filled from auto-generated values.
What You Can Override
Basic Fields
| Field | Purpose |
|---|---|
| Title | Browser tab title and social title |
| Description | Meta description and social description |
| Keywords | Meta keywords tag |
| Robots | Index/follow directives |
| Canonical URL | Override the auto-generated canonical |
Open Graph
| Field | Purpose |
|---|---|
| OG Title | og:title tag |
| OG Description | og:description tag |
| OG Image | og:image — social share image |
| OG Image Alt | Alt text for the OG image |
| OG Locale | Language/locale (default: en_US) |
Twitter Card
| Field | Purpose |
|---|---|
| Twitter Title | twitter:title tag |
| Twitter Description | twitter:description tag |
| Twitter Image | twitter:image — separate from OG image |
| Twitter Image Alt | Alt text for the Twitter image |
| Twitter Creator | twitter:creator — author handle |
JSON-LD
| Field | Purpose |
|---|---|
| Headline | Schema headline |
| Abstract | Schema abstract |
| Article Section | Schema article section |
| Publisher Name | Organization name in schema |
| Author Name | Author name in schema |
OG Image
You can set a custom OG image by:
- Clicking the OG Image field in the sidebar.
- Uploading a new image or pasting a URL.
- The recommended size is 1200×630px.
If no custom OG image is set, the system uses paper.thumbnailUrl first, then falls back to the default app logo.
How Custom Values Override Auto Tags
When a paper has custom metadata set, the system uses those values directly for the corresponding fields. Fields not explicitly set in custom metadata still use auto-inferred values.
The resolution priority for each field:
- Custom metadata value (if set and non-empty).
- Inferred value from paper body/title.
- Framework default.
Viewing the Result
After saving custom metadata:
- Check the Auto Tags page for details on the full output structure: Auto Tags.
- View the page source or use your browser's DevTools to inspect the rendered
<head>. - Use the Facebook Sharing Debugger or Twitter Card Validator to preview social shares.
