---
slug: widget-library
title: "Widget Library"
kind: guide
status: published
hash: f86676ff091456123b760dc125d0db9be3dbdd3a27ca8a5130fbadfdeaad98b6
created: 2026-11-10T10:20:03.696Z
updated: 2026-11-10T10:32:25.091Z
summary: "Try the social, prompt, and API widgets. See the source cards and JSON blocks that can be placed inside an article."
tags: []
above: []
below: []
adjacent: []
nested: []
---
# Widget Library

*Try the social, prompt, and API widgets. See the source cards and JSON blocks that can be placed inside an article.*

## Interactive widgets
Choose a social source, copy or edit a prompt, or build a request from a documented contract. Start with a preset, review its fields, then copy the body, complete request JSON, or cURL.

## Social sources
A source card keeps the platform’s presentation and opens the original. The player controls above load provider-hosted media on request.

```widget
{
  "type": "youtube",
  "id": "nasa-webb-video",
  "channel": "NASA",
  "title": "Highlights from Webb’s first images",
  "url": "https://www.youtube.com/watch?v=1C_zuHf6lP4",
  "thumbnail": "https://i.ytimg.com/vi/1C_zuHf6lP4/hqdefault.jpg"
}
```

```widget
{
  "type": "reddit",
  "id": "nasa-webb-reddit",
  "author": "u/nasa",
  "subreddit": "r/nasa",
  "title": "The first full-color images from the James Webb Space Telescope",
  "url": "https://www.reddit.com/r/nasa/comments/vxdrpy/",
  "date": "2022-07-12"
}
```

See a [Facebook profile card](/a/mark-zuckerberg-facebook), [documentation sources in a research article](/a/mcp-as-a-projection), and [government and place records](/a/marin-county).

## Prompt text
Choose a template, edit the text, then copy it as plain text. Variables such as `{{city}}` stay visible until you replace them.

## API invocation
The builder covers Google Places Text Search, OpenRouter chat, Higgsfield image and video, Apify actor input, and the build’s FILES tool over MCP and Directory REST. The Fields panel explains required inputs, optional values, and how to read the response. Run copied requests from your authorized client with its environment credentials.

```widget
{
  "type": "json",
  "title": "Places city-only request body",
  "value": {
    "textQuery": "Mill Valley, CA"
  }
}
```

## Source and layout catalog
Open any example to compare the rendered widget with its JSON. Keep the source URL and its date with the item they support.

```widget
{
  "type": "example",
  "title": "County object",
  "widget": {
    "type": "entity",
    "ref": "marin-county"
  }
}
```

```widget
{
  "type": "example",
  "title": "Facebook profile object",
  "widget": {
    "type": "entity",
    "ref": "mark-zuckerberg-facebook"
  }
}
```

```widget
{
  "type": "example",
  "title": "Documentation evidence",
  "widget": {
    "type": "source",
    "source_type": "statement",
    "title": "Tools specification",
    "publisher": "Model Context Protocol",
    "url": "https://modelcontextprotocol.io/specification/2025-11-25/server/tools"
  }
}
```

```widget
{
  "type": "table",
  "columns": [
    {
      "key": "family",
      "label": "Widget family"
    },
    {
      "key": "type",
      "label": "Types"
    },
    {
      "key": "use",
      "label": "Placement"
    }
  ],
  "rows": [
    {
      "family": "Social",
      "type": "youtube · reddit · x · instagram · facebook · linkedin · tiktok",
      "use": "Use a direct public URL and the supported source fields."
    },
    {
      "family": "Source evidence",
      "type": "source · wikipedia",
      "use": "Use source IDs or documented source fields and URLs."
    },
    {
      "family": "Objects",
      "type": "entity · article · object_image · object_field · object_group",
      "use": "Reference the stored object or a field of it."
    },
    {
      "family": "Reading aids",
      "type": "note · quote · stat · caveat · thread",
      "use": "Place text, callouts or expandable context in the reading flow."
    },
    {
      "family": "Data and media",
      "type": "json · table · image · gallery",
      "use": "Display values, rows, images or a group of images."
    },
    {
      "family": "Live workspace",
      "type": "space · object",
      "use": "Reference a workspace or an application object."
    }
  ]
}
```

## Place a widget in an article
Include an approved typed block in `body` or place a widget from the `widgets` array with `[[widget:id]]` on its own line. An `entity` block points at a stored object. A `source` block can point at a source ID on the article. Open the article’s JSON to see how its examples are stored.

```widget
{
  "type": "json",
  "title": "Article placement example",
  "value": {
    "widgets": [
      {
        "id": "webb-video",
        "type": "youtube",
        "channel": "NASA",
        "title": "Highlights from Webb’s first images",
        "url": "https://www.youtube.com/watch?v=1C_zuHf6lP4"
      }
    ],
    "body": [
      "## Social sources",
      "[[widget:webb-video]]"
    ]
  }
}
```

[Widget and workspace catalog](/console/widgets.html) · [Standalone widget layouts](/console/designs/presentation/index.html?editorial=1&mode=library) · [JSON Rules and REST](/a/json-articles-how-they-work)

## Sources

1. [Highlights from Webb’s first images](https://www.youtube.com/watch?v=1C_zuHf6lP4)
2. [The first full-color images from the James Webb Space Telescope](https://www.reddit.com/r/nasa/comments/vxdrpy/)
3. [Text Search (New)](https://developers.google.com/maps/documentation/places/web-service/text-search)