Skip to content

Image Description

The Image type is defined in ActivityStreams Vocabulary.

In this support table, we only consider how the image description, commonly called AltText is handled. Image descriptions are important from an accessibility standpoint, see WCAG 2.2. Text Alternatives.

It seems that certain implementations, e.g. firefish, store the image description on a per image URL basis and not for every instance of an image reference.

Examples

Example 1

```json title="activity"
{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    {
      "Hashtag": "as:Hashtag",
      "sensitive": "as:sensitive"
    }
  ],
  "type": "Create",
  "actor": "http://pasture_one_actor/actor",
  "to": [
    "http://misskey/users/9qjn4jz0rqol0001",
    "https://www.w3.org/ns/activitystreams#Public"
  ],
  "id": "http://pasture_one_actor/actor/y6b9Kz4DVIY",
  "object": {
    "type": "Note",
    "attributedTo": "http://pasture_one_actor/actor",
    "to": [
      "https://www.w3.org/ns/activitystreams#Public",
      "http://misskey/users/9qjn4jz0rqol0001"
    ],
    "id": "http://pasture_one_actor/actor/NvkG3rF590g",
    "published": "2024-03-06T17:34:14Z",
    "content": "no description",
    "attachment": {
      "type": "Document",
      "url": "http://pasture_one_actor/images/100.png"
    }
  }
}
```


```json title="misskey"
{
  "id": "9qjn7gfk3ffu000s",
  "createdAt": "2024-03-06T17:34:14.000Z",
  "userId": "9qjn65mj3ffu0004",
  "user": {
    "id": "9qjn65mj3ffu0004",
    "name": "Test Actor",
    "username": "actor",
    "host": "pasture_one_actor",
    "avatarUrl": "http://misskey/identicon/actor@pasture_one_actor",
    "avatarBlurhash": null,
    "avatarDecorations": [],
    "isBot": false,
    "isCat": false,
    "instance": {
      "name": null,
      "softwareName": null,
      "softwareVersion": null,
      "iconUrl": null,
      "faviconUrl": null,
      "themeColor": null
    },
    "emojis": {},
    "onlineStatus": "unknown"
  },
  "text": "no description",
  "cw": null,
  "visibility": "public",
  "localOnly": false,
  "reactionAcceptance": null,
  "renoteCount": 0,
  "repliesCount": 0,
  "reactions": {},
  "reactionEmojis": {},
  "emojis": {},
  "fileIds": [
    "9qjn7gpl3ffu000r"
  ],
  "files": [
    {
      "id": "9qjn7gpl3ffu000r",
      "createdAt": "2024-03-06T17:34:14.361Z",
      "name": "100.png",
      "type": "image/png",
      "md5": "63b90924c425bacf4e14787f5928e24f",
      "size": 0,
      "isSensitive": false,
      "blurhash": "e3PB0n}KfQ}KfQ}KjufQjufQfQfQfQfQfQ}KjufQjufQfQfQfQfQfQ",
      "properties": {
        "width": 40,
        "height": 40
      },
      "url": "http://pasture_one_actor/images/100.png",
      "thumbnailUrl": "http://pasture_one_actor/images/100.png",
      "comment": null,
      "folderId": null,
      "folder": null,
      "userId": null,
      "user": null
    }
  ],
  "replyId": null,
  "renoteId": null,
  "uri": "http://pasture_one_actor/actor/NvkG3rF590g",
  "clippedCount": 0
}
```

Example 2

```json title="activity"
{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    {
      "Hashtag": "as:Hashtag",
      "sensitive": "as:sensitive"
    }
  ],
  "type": "Create",
  "actor": "http://pasture_one_actor/actor",
  "to": [
    "http://misskey/users/9qjn4jz0rqol0001",
    "https://www.w3.org/ns/activitystreams#Public"
  ],
  "id": "http://pasture_one_actor/actor/XO3dnzF4_y4",
  "object": {
    "type": "Note",
    "attributedTo": "http://pasture_one_actor/actor",
    "to": [
      "https://www.w3.org/ns/activitystreams#Public",
      "http://misskey/users/9qjn4jz0rqol0001"
    ],
    "id": "http://pasture_one_actor/actor/U2sJLKlnHYA",
    "published": "2024-03-06T17:34:16Z",
    "content": "text",
    "attachment": {
      "type": "Document",
      "url": "http://pasture_one_actor/images/100.png",
      "name": "name",
      "summary": "summary",
      "content": "content"
    }
  }
}
```


```json title="misskey"
{
  "id": "9qjn7hz43ffu000u",
  "createdAt": "2024-03-06T17:34:16.000Z",
  "userId": "9qjn65mj3ffu0004",
  "user": {
    "id": "9qjn65mj3ffu0004",
    "name": "Test Actor",
    "username": "actor",
    "host": "pasture_one_actor",
    "avatarUrl": "http://misskey/identicon/actor@pasture_one_actor",
    "avatarBlurhash": null,
    "avatarDecorations": [],
    "isBot": false,
    "isCat": false,
    "instance": {
      "name": null,
      "softwareName": null,
      "softwareVersion": null,
      "iconUrl": null,
      "faviconUrl": null,
      "themeColor": null
    },
    "emojis": {},
    "onlineStatus": "unknown"
  },
  "text": "text",
  "cw": null,
  "visibility": "public",
  "localOnly": false,
  "reactionAcceptance": null,
  "renoteCount": 0,
  "repliesCount": 0,
  "reactions": {},
  "reactionEmojis": {},
  "emojis": {},
  "fileIds": [
    "9qjn7icz3ffu000t"
  ],
  "files": [
    {
      "id": "9qjn7icz3ffu000t",
      "createdAt": "2024-03-06T17:34:16.499Z",
      "name": "100.png",
      "type": "image/png",
      "md5": "95b0d89b954d6b30f9c742ebdaf2f0ec",
      "size": 0,
      "isSensitive": false,
      "blurhash": "e27=x}uPfQuPfQuPfkfQfkfQfQfQfQfQfQuPfkfQfkfQfQfQfQfQfQ",
      "properties": {
        "width": 40,
        "height": 40
      },
      "url": "http://pasture_one_actor/images/100.png",
      "thumbnailUrl": "http://pasture_one_actor/images/100.png",
      "comment": "name",
      "folderId": null,
      "folder": null,
      "userId": null,
      "user": null
    }
  ],
  "replyId": null,
  "renoteId": null,
  "uri": "http://pasture_one_actor/actor/U2sJLKlnHYA",
  "clippedCount": 0
}
```

Example 3

```json title="activity"
{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    {
      "Hashtag": "as:Hashtag",
      "sensitive": "as:sensitive"
    }
  ],
  "type": "Create",
  "actor": "http://pasture_one_actor/actor",
  "to": [
    "http://misskey/users/9qjn4jz0rqol0001",
    "https://www.w3.org/ns/activitystreams#Public"
  ],
  "id": "http://pasture_one_actor/actor/4mqxRnW8Ed8",
  "object": {
    "type": "Note",
    "attributedTo": "http://pasture_one_actor/actor",
    "to": [
      "https://www.w3.org/ns/activitystreams#Public",
      "http://misskey/users/9qjn4jz0rqol0001"
    ],
    "id": "http://pasture_one_actor/actor/oxMfBQJwiLg",
    "published": "2024-03-06T17:34:18Z",
    "content": "text",
    "attachment": [
      {
        "type": "Document",
        "url": "http://pasture_one_actor/assets/FediverseLogo.png",
        "name": "name",
        "imageType": "image/jpeg"
      }
    ]
  }
}
```


```json title="misskey"
{
  "id": "9qjn7jio3ffu000w",
  "createdAt": "2024-03-06T17:34:18.000Z",
  "userId": "9qjn65mj3ffu0004",
  "user": {
    "id": "9qjn65mj3ffu0004",
    "name": "Test Actor",
    "username": "actor",
    "host": "pasture_one_actor",
    "avatarUrl": "http://misskey/identicon/actor@pasture_one_actor",
    "avatarBlurhash": null,
    "avatarDecorations": [],
    "isBot": false,
    "isCat": false,
    "instance": {
      "name": null,
      "softwareName": null,
      "softwareVersion": null,
      "iconUrl": null,
      "faviconUrl": null,
      "themeColor": null
    },
    "emojis": {},
    "onlineStatus": "unknown"
  },
  "text": "text",
  "cw": null,
  "visibility": "public",
  "localOnly": false,
  "reactionAcceptance": null,
  "renoteCount": 0,
  "repliesCount": 0,
  "reactions": {},
  "reactionEmojis": {},
  "emojis": {},
  "fileIds": [
    "9qjn7k073ffu000v"
  ],
  "files": [
    {
      "id": "9qjn7k073ffu000v",
      "createdAt": "2024-03-06T17:34:18.631Z",
      "name": "FediverseLogo.png",
      "type": "image/png",
      "md5": "85e7feae66363e9e200570a28b0cf20a",
      "size": 0,
      "isSensitive": false,
      "blurhash": "eQE_?c.}4.YJM^}fi{EVw[xu9JK[M~xI-T9+TJRPX2$$E]NFo}j1tO",
      "properties": {
        "width": 1548,
        "height": 1548
      },
      "url": "http://pasture_one_actor/assets/FediverseLogo.png",
      "thumbnailUrl": "http://pasture_one_actor/assets/FediverseLogo.png",
      "comment": "name",
      "folderId": null,
      "folder": null,
      "userId": null,
      "user": null
    }
  ],
  "replyId": null,
  "renoteId": null,
  "uri": "http://pasture_one_actor/actor/oxMfBQJwiLg",
  "clippedCount": 0
}
```

Example 4

```json title="activity"
{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    {
      "Hashtag": "as:Hashtag",
      "sensitive": "as:sensitive"
    }
  ],
  "type": "Create",
  "actor": "http://pasture_one_actor/actor",
  "to": [
    "http://misskey/users/9qjn4jz0rqol0001",
    "https://www.w3.org/ns/activitystreams#Public"
  ],
  "id": "http://pasture_one_actor/actor/AjWa_T-k9Nw",
  "object": {
    "type": "Note",
    "attributedTo": "http://pasture_one_actor/actor",
    "to": [
      "https://www.w3.org/ns/activitystreams#Public",
      "http://misskey/users/9qjn4jz0rqol0001"
    ],
    "id": "http://pasture_one_actor/actor/22e9qfpNGEA",
    "published": "2024-03-06T17:34:20Z",
    "content": "no comment in attachment",
    "attachment": [
      {
        "type": "Document",
        "url": "http://pasture_one_actor/assets/FediverseLogo.png"
      }
    ]
  }
}
```


```json title="misskey"
{
  "id": "9qjn7l283ffu000x",
  "createdAt": "2024-03-06T17:34:20.000Z",
  "userId": "9qjn65mj3ffu0004",
  "user": {
    "id": "9qjn65mj3ffu0004",
    "name": "Test Actor",
    "username": "actor",
    "host": "pasture_one_actor",
    "avatarUrl": "http://misskey/identicon/actor@pasture_one_actor",
    "avatarBlurhash": null,
    "avatarDecorations": [],
    "isBot": false,
    "isCat": false,
    "instance": {
      "name": null,
      "softwareName": null,
      "softwareVersion": null,
      "iconUrl": null,
      "faviconUrl": null,
      "themeColor": null
    },
    "emojis": {},
    "onlineStatus": "unknown"
  },
  "text": "no comment in attachment",
  "cw": null,
  "visibility": "public",
  "localOnly": false,
  "reactionAcceptance": null,
  "renoteCount": 0,
  "repliesCount": 0,
  "reactions": {},
  "reactionEmojis": {},
  "emojis": {},
  "fileIds": [
    "9qjn7k073ffu000v"
  ],
  "files": [
    {
      "id": "9qjn7k073ffu000v",
      "createdAt": "2024-03-06T17:34:18.631Z",
      "name": "FediverseLogo.png",
      "type": "image/png",
      "md5": "85e7feae66363e9e200570a28b0cf20a",
      "size": 0,
      "isSensitive": false,
      "blurhash": "eQE_?c.}4.YJM^}fi{EVw[xu9JK[M~xI-T9+TJRPX2$$E]NFo}j1tO",
      "properties": {
        "width": 1548,
        "height": 1548
      },
      "url": "http://pasture_one_actor/assets/FediverseLogo.png",
      "thumbnailUrl": "http://pasture_one_actor/assets/FediverseLogo.png",
      "comment": "name",
      "folderId": null,
      "folder": null,
      "userId": null,
      "user": null
    }
  ],
  "replyId": null,
  "renoteId": null,
  "uri": "http://pasture_one_actor/actor/22e9qfpNGEA",
  "clippedCount": 0
}
```