# app.bsky.embed.images

> Published by [bsky-lexicons.bsky.social](https://lexicon.garden/identity/did:plc:4v4y5r3lwsbtmsxhile2ljac)

✓ This is the authoritative definition for this NSID.

## Description

A set of images embedded in a Bluesky record (eg, a post).

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:4v4y5r3lwsbtmsxhile2ljac/app.bsky.embed.images)
- [Documentation](https://lexicon.garden/lexicon/did:plc:4v4y5r3lwsbtmsxhile2ljac/app.bsky.embed.images/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:4v4y5r3lwsbtmsxhile2ljac/app.bsky.embed.images/examples)

## Definitions

### `app.bsky.embed.images`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `images` | `array` | Yes |  |

### `app.bsky.embed.images#view`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `images` | `array` | Yes |  |

### `app.bsky.embed.images#image`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `alt` | `string` | Yes | Alt text description of the image, for accessibility. |
| `image` | `blob` | Yes | The raw image file. May be up to 2 MB, formerly limited to 1 MB. |
| `aspectRatio` | `ref` → `app.bsky.embed.defs#aspectRatio` | No |  |

### `app.bsky.embed.images#viewImage`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `alt` | `string` | Yes | Alt text description of the image, for accessibility. |
| `thumb` | `string` (uri) | Yes | Fully-qualified URL where a thumbnail of the image can be fetched. For example, CDN location provided by the App View. |
| `fullsize` | `string` (uri) | Yes | Fully-qualified URL where a large version of the image can be fetched. May or may not be the exact original blob. For example, CDN location provided by the App View. |
| `aspectRatio` | `ref` → `app.bsky.embed.defs#aspectRatio` | No |  |

## Raw Schema

```json
{
  "id": "app.bsky.embed.images",
  "defs": {
    "main": {
      "type": "object",
      "required": [
        "images"
      ],
      "properties": {
        "images": {
          "type": "array",
          "items": {
            "ref": "#image",
            "type": "ref"
          },
          "maxLength": 4
        }
      }
    },
    "view": {
      "type": "object",
      "required": [
        "images"
      ],
      "properties": {
        "images": {
          "type": "array",
          "items": {
            "ref": "#viewImage",
            "type": "ref"
          },
          "maxLength": 4
        }
      }
    },
    "image": {
      "type": "object",
      "required": [
        "image",
        "alt"
      ],
      "properties": {
        "alt": {
          "type": "string",
          "description": "Alt text description of the image, for accessibility."
        },
        "image": {
          "type": "blob",
          "accept": [
            "image/*"
          ],
          "maxSize": 2000000,
          "description": "The raw image file. May be up to 2 MB, formerly limited to 1 MB."
        },
        "aspectRatio": {
          "ref": "app.bsky.embed.defs#aspectRatio",
          "type": "ref"
        }
      }
    },
    "viewImage": {
      "type": "object",
      "required": [
        "thumb",
        "fullsize",
        "alt"
      ],
      "properties": {
        "alt": {
          "type": "string",
          "description": "Alt text description of the image, for accessibility."
        },
        "thumb": {
          "type": "string",
          "format": "uri",
          "description": "Fully-qualified URL where a thumbnail of the image can be fetched. For example, CDN location provided by the App View."
        },
        "fullsize": {
          "type": "string",
          "format": "uri",
          "description": "Fully-qualified URL where a large version of the image can be fetched. May or may not be the exact original blob. For example, CDN location provided by the App View."
        },
        "aspectRatio": {
          "ref": "app.bsky.embed.defs#aspectRatio",
          "type": "ref"
        }
      }
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1,
  "description": "A set of images embedded in a Bluesky record (eg, a post)."
}
```
