Recommended Media Attachment Format¶
The first three example are our recommendation on how to format image, video, and audio media attachments. Further properties are possible, and might make it into this recommendation at one point. Examples:
- Focal point and blurhash, see Mastodon
- fps (frames per second) for videos
The final example cannot be recommended yet as it is not widely supported. However, it illustrates how one can provide multiple versions of the media attachments. A high quality and low quality video in this case. The low quality video is enough for most use cases, and is 40 times smaller.
The recommended format is documented in FEP-1311: Media Attachments.
Examples¶
Example 1¶
activity
{
"@context": [
"https://www.w3.org/ns/activitystreams",
{
"Hashtag": "as:Hashtag",
"sensitive": "as:sensitive"
}
],
"type": "Create",
"actor": "http://pasture-one-actor/actor",
"to": [
"http://hollo/@john",
"as:Public"
],
"id": "http://pasture-one-actor/activity/uTYsng0qGOU",
"published": "2025-08-27T08:15:22Z",
"object": {
"type": "Note",
"attributedTo": "http://pasture-one-actor/actor",
"to": [
"as:Public",
"http://hollo/@john"
],
"id": "http://pasture-one-actor/object/1ftGzweHnFo",
"published": "2025-08-27T08:15:22Z",
"@context": [
"https://www.w3.org/ns/activitystreams",
"https://www.w3.org/ns/credentials/v2",
{
"size": "https://joinpeertube.org/ns#size"
}
],
"content": "Recommended Image Format",
"attachment": [
{
"type": "Image",
"name": "A beautiful cow",
"url": "http://pasture-one-actor/assets/cow.jpg",
"width": 100,
"height": 162,
"mediaType": "image/jpeg",
"digestMultibase": "zQmaeDPzhNL32WQZnnzB1H6QJWvvFNEHdViDB71yrxyXU1t",
"size": 9045
}
]
}
}
gotosocial
{
"id": "01K3GV8WF0K1YQ5134FR8Y8CW9",
"created_at": "2025-08-25T14:49:16.000Z",
"in_reply_to_id": null,
"in_reply_to_account_id": null,
"sensitive": false,
"spoiler_text": "",
"visibility": "public",
"language": null,
"uri": "http://pasture-one-actor/object/bJAROcDA6AY",
"url": "http://pasture-one-actor/object/bJAROcDA6AY",
"replies_count": 0,
"reblogs_count": 0,
"favourites_count": 0,
"favourited": false,
"reblogged": false,
"muted": false,
"bookmarked": false,
"pinned": false,
"content": "Recommended Image Format<hr><p><i lang=\"en\">\u2139\ufe0f Note from gotosocial: 1 attachment in this status could not be downloaded. Treat the following external link with care:</i></p><ul><li><a href=\"http://pasture-one-actor/assets/cow.jpg\" rel=\"nofollow noreferrer noopener\" target=\"_blank\">cow.jpg</a> [A beautiful cow]</li></ul>",
"reblog": null,
"account": {
"id": "01K3GV8459F044M7E2J13WTR56",
"username": "actor",
"acct": "actor@pasture-one-actor",
"display_name": "Test Actor",
"locked": true,
"discoverable": false,
"bot": false,
"created_at": "2025-08-25T14:48:51.133Z",
"note": "",
"url": "http://pasture-one-actor/actor",
"avatar": "http://gotosocial/assets/default_avatars/GoToSocial_icon5.png",
"avatar_static": "http://gotosocial/assets/default_avatars/GoToSocial_icon5.png",
"header": "http://gotosocial/assets/default_header.png",
"header_static": "http://gotosocial/assets/default_header.png",
"followers_count": 0,
"following_count": 0,
"statuses_count": 22,
"last_status_at": "2025-08-25T14:49:16.000Z",
"emojis": [],
"fields": []
},
"media_attachments": [],
"mentions": [
{
"id": "01KA518HV2YMVXQKRA76EF2ZJV",
"username": "cookie",
"url": "http://gotosocial/@cookie",
"acct": "cookie"
}
],
"tags": [],
"emojis": [],
"card": null,
"poll": null
}
hollo
{
"id": "0198ea98-8990-77e2-909b-272a31477b1d",
"created_at": "2025-08-27T08:15:22.000Z",
"in_reply_to_id": null,
"sensitive": false,
"spoiler_text": "",
"visibility": "public",
"language": null,
"uri": "http://pasture-one-actor/object/1ftGzweHnFo",
"url": "http://pasture-one-actor/object/1ftGzweHnFo",
"replies_count": 0,
"reblogs_count": 0,
"favourites_count": 0,
"favourited": false,
"reblogged": false,
"muted": false,
"bookmarked": false,
"pinned": false,
"content": "Recommended Image Format",
"reblog": null,
"quote_id": null,
"quote": null,
"application": null,
"account": {
"id": "0198ea98-1daf-74ca-ab5b-29bdfc9e43ad",
"username": "actor",
"acct": "actor@pasture-one-actor",
"display_name": "Test Actor",
"locked": false,
"bot": false,
"created_at": "2025-08-27T08:14:54.323Z",
"note": "",
"url": "http://pasture-one-actor/actor",
"avatar": "http://hollo/image/avatars/original/missing.png",
"avatar_static": "http://hollo/image/avatars/original/missing.png",
"header": "http://hollo/image/headers/original/missing.png",
"header_static": "http://hollo/image/headers/original/missing.png",
"followers_count": 0,
"following_count": 0,
"statuses_count": 0,
"moved": null,
"last_status_at": null,
"emojis": [],
"fields": []
},
"media_attachments": [
{
"id": "0198ea98-9110-78ca-91b9-65bd25a6d0b2",
"type": "image",
"url": "http://pasture-one-actor/assets/cow.jpg",
"preview_url": "http://pasture-one-actor/assets/cow.jpg",
"remote_url": null,
"text_url": null,
"meta": {
"original": {
"width": 100,
"height": 162,
"size": "100x162",
"aspect": 0.6172839506172839
},
"small": {
"width": 100,
"height": 162,
"size": "100x162",
"aspect": 0.6172839506172839
},
"focus": {
"x": 0,
"y": 0
}
},
"description": null,
"blurhash": null
}
],
"mentions": [],
"tags": [],
"card": null,
"emojis": [],
"emoji_reactions": [],
"poll": null,
"filtered": null
}
Example 2¶
activity
{
"@context": [
"https://www.w3.org/ns/activitystreams",
{
"Hashtag": "as:Hashtag",
"sensitive": "as:sensitive"
}
],
"type": "Create",
"actor": "http://pasture-one-actor/actor",
"to": [
"http://hollo/@john",
"as:Public"
],
"id": "http://pasture-one-actor/activity/FA2dgklblNU",
"published": "2025-08-27T08:15:24Z",
"object": {
"type": "Note",
"attributedTo": "http://pasture-one-actor/actor",
"to": [
"as:Public",
"http://hollo/@john"
],
"id": "http://pasture-one-actor/object/WEL0tbE-GC0",
"published": "2025-08-27T08:15:24Z",
"@context": [
"https://www.w3.org/ns/activitystreams",
"https://www.w3.org/ns/credentials/v2",
{
"size": "https://joinpeertube.org/ns#size"
}
],
"content": "Recommended Video Attachment",
"attachment": [
{
"type": "Video",
"url": "http://pasture-one-actor/assets/cow_eating.mp4",
"name": "A beautiful cow eating",
"width": 256,
"height": 144,
"mediaType": "video/mp4",
"digestMultibase": "zQmSzK5qEe5tpjwGMhmjx9RvVoPkWhEmCwxP2s7wPMpKMoK",
"size": 54373,
"duration": "PT3S"
}
]
}
}
gotosocial
{
"id": "01K3GV8WF04YY00Y59T4TGT5H2",
"created_at": "2025-08-25T14:49:16.000Z",
"in_reply_to_id": null,
"in_reply_to_account_id": null,
"sensitive": false,
"spoiler_text": "",
"visibility": "public",
"language": null,
"uri": "http://pasture-one-actor/object/y-FT5RkWrNI",
"url": "http://pasture-one-actor/object/y-FT5RkWrNI",
"replies_count": 0,
"reblogs_count": 0,
"favourites_count": 0,
"favourited": false,
"reblogged": false,
"muted": false,
"bookmarked": false,
"pinned": false,
"content": "Recommended Video Attachment<hr><p><i lang=\"en\">\u2139\ufe0f Note from gotosocial: 1 attachment in this status could not be downloaded. Treat the following external link with care:</i></p><ul><li><a href=\"http://pasture-one-actor/assets/cow_eating.mp4\" rel=\"nofollow noreferrer noopener\" target=\"_blank\">cow_eating.mp4</a> [A beautiful cow eating]</li></ul>",
"reblog": null,
"account": {
"id": "01K3GV8459F044M7E2J13WTR56",
"username": "actor",
"acct": "actor@pasture-one-actor",
"display_name": "Test Actor",
"locked": true,
"discoverable": false,
"bot": false,
"created_at": "2025-08-25T14:48:51.133Z",
"note": "",
"url": "http://pasture-one-actor/actor",
"avatar": "http://gotosocial/assets/default_avatars/GoToSocial_icon5.png",
"avatar_static": "http://gotosocial/assets/default_avatars/GoToSocial_icon5.png",
"header": "http://gotosocial/assets/default_header.png",
"header_static": "http://gotosocial/assets/default_header.png",
"followers_count": 0,
"following_count": 0,
"statuses_count": 23,
"last_status_at": "2025-08-25T14:49:16.000Z",
"emojis": [],
"fields": []
},
"media_attachments": [],
"mentions": [
{
"id": "01KA518HV2YMVXQKRA76EF2ZJV",
"username": "cookie",
"url": "http://gotosocial/@cookie",
"acct": "cookie"
}
],
"tags": [],
"emojis": [],
"card": null,
"poll": null
}
hollo
{
"id": "0198ea98-9160-72ce-8783-4d609753e745",
"created_at": "2025-08-27T08:15:24.000Z",
"in_reply_to_id": null,
"sensitive": false,
"spoiler_text": "",
"visibility": "public",
"language": null,
"uri": "http://pasture-one-actor/object/WEL0tbE-GC0",
"url": "http://pasture-one-actor/object/WEL0tbE-GC0",
"replies_count": 0,
"reblogs_count": 0,
"favourites_count": 0,
"favourited": false,
"reblogged": false,
"muted": false,
"bookmarked": false,
"pinned": false,
"content": "Recommended Video Attachment",
"reblog": null,
"quote_id": null,
"quote": null,
"application": null,
"account": {
"id": "0198ea98-1daf-74ca-ab5b-29bdfc9e43ad",
"username": "actor",
"acct": "actor@pasture-one-actor",
"display_name": "Test Actor",
"locked": false,
"bot": false,
"created_at": "2025-08-27T08:14:54.323Z",
"note": "",
"url": "http://pasture-one-actor/actor",
"avatar": "http://hollo/image/avatars/original/missing.png",
"avatar_static": "http://hollo/image/avatars/original/missing.png",
"header": "http://hollo/image/headers/original/missing.png",
"header_static": "http://hollo/image/headers/original/missing.png",
"followers_count": 0,
"following_count": 0,
"statuses_count": 0,
"moved": null,
"last_status_at": null,
"emojis": [],
"fields": []
},
"media_attachments": [
{
"id": "0198ea98-93c4-705d-ac9c-0f66aa4e4e14",
"type": "video",
"url": "http://pasture-one-actor/assets/cow_eating.mp4",
"preview_url": "http://pasture-one-actor/assets/cow_eating.mp4",
"remote_url": null,
"text_url": null,
"meta": {
"original": {
"width": 256,
"height": 144,
"size": "256x144",
"aspect": 1.7777777777777777
},
"small": {
"width": 256,
"height": 144,
"size": "256x144",
"aspect": 1.7777777777777777
},
"focus": {
"x": 0,
"y": 0
}
},
"description": null,
"blurhash": null
}
],
"mentions": [],
"tags": [],
"card": null,
"emojis": [],
"emoji_reactions": [],
"poll": null,
"filtered": null
}
Example 3¶
activity
{
"@context": [
"https://www.w3.org/ns/activitystreams",
{
"Hashtag": "as:Hashtag",
"sensitive": "as:sensitive"
}
],
"type": "Create",
"actor": "http://pasture-one-actor/actor",
"to": [
"http://hollo/@john",
"as:Public"
],
"id": "http://pasture-one-actor/activity/_icLgWWQSRw",
"published": "2025-08-27T08:15:25Z",
"object": {
"type": "Note",
"attributedTo": "http://pasture-one-actor/actor",
"to": [
"as:Public",
"http://hollo/@john"
],
"id": "http://pasture-one-actor/object/EKqIHg3fMMg",
"published": "2025-08-27T08:15:25Z",
"@context": [
"https://www.w3.org/ns/activitystreams",
"https://www.w3.org/ns/credentials/v2",
{
"size": "https://joinpeertube.org/ns#size"
}
],
"content": "Recommended Audio Format",
"attachment": [
{
"type": "Audio",
"url": "http://pasture-one-actor/assets/cow_moo.mp3",
"name": "A cow mooing",
"mediaType": "audio/mpeg",
"digestMultibase": "zQmSXTyLCPqoiGoUUwKRMKgFdddaAUkvQNr29nhB6tahb9Z",
"size": 67709,
"duration": "PT2.1S"
}
]
}
}
gotosocial
{
"id": "01K3GV8XE8JBR5Y3XF39652MHB",
"created_at": "2025-08-25T14:49:17.000Z",
"in_reply_to_id": null,
"in_reply_to_account_id": null,
"sensitive": false,
"spoiler_text": "",
"visibility": "public",
"language": null,
"uri": "http://pasture-one-actor/object/AR5tJ3svpQk",
"url": "http://pasture-one-actor/object/AR5tJ3svpQk",
"replies_count": 0,
"reblogs_count": 0,
"favourites_count": 0,
"favourited": false,
"reblogged": false,
"muted": false,
"bookmarked": false,
"pinned": false,
"content": "Recommended Audio Format<hr><p><i lang=\"en\">\u2139\ufe0f Note from gotosocial: 1 attachment in this status could not be downloaded. Treat the following external link with care:</i></p><ul><li><a href=\"http://pasture-one-actor/assets/cow_moo.mp3\" rel=\"nofollow noreferrer noopener\" target=\"_blank\">cow_moo.mp3</a> [A cow mooing]</li></ul>",
"reblog": null,
"account": {
"id": "01K3GV8459F044M7E2J13WTR56",
"username": "actor",
"acct": "actor@pasture-one-actor",
"display_name": "Test Actor",
"locked": true,
"discoverable": false,
"bot": false,
"created_at": "2025-08-25T14:48:51.133Z",
"note": "",
"url": "http://pasture-one-actor/actor",
"avatar": "http://gotosocial/assets/default_avatars/GoToSocial_icon5.png",
"avatar_static": "http://gotosocial/assets/default_avatars/GoToSocial_icon5.png",
"header": "http://gotosocial/assets/default_header.png",
"header_static": "http://gotosocial/assets/default_header.png",
"followers_count": 0,
"following_count": 0,
"statuses_count": 24,
"last_status_at": "2025-08-25T14:49:17.000Z",
"emojis": [],
"fields": []
},
"media_attachments": [],
"mentions": [
{
"id": "01KA518HV2YMVXQKRA76EF2ZJV",
"username": "cookie",
"url": "http://gotosocial/@cookie",
"acct": "cookie"
}
],
"tags": [],
"emojis": [],
"card": null,
"poll": null
}
hollo
{
"id": "0198ea98-9548-7d84-9a2f-629f8c8550d0",
"created_at": "2025-08-27T08:15:25.000Z",
"in_reply_to_id": null,
"sensitive": false,
"spoiler_text": "",
"visibility": "public",
"language": null,
"uri": "http://pasture-one-actor/object/EKqIHg3fMMg",
"url": "http://pasture-one-actor/object/EKqIHg3fMMg",
"replies_count": 0,
"reblogs_count": 0,
"favourites_count": 0,
"favourited": false,
"reblogged": false,
"muted": false,
"bookmarked": false,
"pinned": false,
"content": "Recommended Audio Format",
"reblog": null,
"quote_id": null,
"quote": null,
"application": null,
"account": {
"id": "0198ea98-1daf-74ca-ab5b-29bdfc9e43ad",
"username": "actor",
"acct": "actor@pasture-one-actor",
"display_name": "Test Actor",
"locked": false,
"bot": false,
"created_at": "2025-08-27T08:14:54.323Z",
"note": "",
"url": "http://pasture-one-actor/actor",
"avatar": "http://hollo/image/avatars/original/missing.png",
"avatar_static": "http://hollo/image/avatars/original/missing.png",
"header": "http://hollo/image/headers/original/missing.png",
"header_static": "http://hollo/image/headers/original/missing.png",
"followers_count": 0,
"following_count": 0,
"statuses_count": 0,
"moved": null,
"last_status_at": null,
"emojis": [],
"fields": []
},
"media_attachments": [
{
"id": "0198ea98-98cd-75fe-b1eb-2fe04b89bf59",
"type": "audio",
"url": "http://pasture-one-actor/assets/cow_moo.mp3",
"preview_url": "http://pasture-one-actor/assets/cow_moo.mp3",
"remote_url": null,
"text_url": null,
"meta": {
"original": {
"width": 512,
"height": 512,
"size": "512x512",
"aspect": 1
},
"small": {
"width": 512,
"height": 512,
"size": "512x512",
"aspect": 1
},
"focus": {
"x": 0,
"y": 0
}
},
"description": null,
"blurhash": null
}
],
"mentions": [],
"tags": [],
"card": null,
"emojis": [],
"emoji_reactions": [],
"poll": null,
"filtered": null
}
Example 4¶
activity
{
"@context": [
"https://www.w3.org/ns/activitystreams",
{
"Hashtag": "as:Hashtag",
"sensitive": "as:sensitive"
}
],
"type": "Create",
"actor": "http://pasture-one-actor/actor",
"to": [
"http://hollo/@john",
"as:Public"
],
"id": "http://pasture-one-actor/activity/RSM_LUrMSTw",
"published": "2025-08-27T08:15:26Z",
"object": {
"type": "Note",
"attributedTo": "http://pasture-one-actor/actor",
"to": [
"as:Public",
"http://hollo/@john"
],
"id": "http://pasture-one-actor/object/g8TmVfctZHs",
"published": "2025-08-27T08:15:26Z",
"@context": [
"https://www.w3.org/ns/activitystreams",
"https://www.w3.org/ns/credentials/v2",
{
"size": "https://joinpeertube.org/ns#size"
}
],
"content": "Multiple formats for video",
"attachment": [
{
"type": "Video",
"name": "A beautiful cow eating",
"url": [
{
"type": "Link",
"size": 54373,
"digest": "zQmSzK5qEe5tpjwGMhmjx9RvVoPkWhEmCwxP2s7wPMpKMoK",
"width": 256,
"height": 144,
"href": "http://pasture-one-actor/assets/cow_eating.mp4",
"mediaType": "video/mp4"
},
{
"type": "Link",
"size": 2271723,
"digest": "zQme2X4rgWuRdmAtGGMSEbdoeRQ2NAL2VptcdRGTYDZbSKG",
"width": 1920,
"height": 1080,
"href": "http://pasture-one-actor/assets/cow_eating_hd.mp4",
"mediaType": "video/mp4"
}
],
"duration": "PT3S"
}
]
}
}
gotosocial
{
"id": "01K3GV8YDG7F9JPQMKVW6C3R7Y",
"created_at": "2025-08-25T14:49:18.000Z",
"in_reply_to_id": null,
"in_reply_to_account_id": null,
"sensitive": false,
"spoiler_text": "",
"visibility": "public",
"language": null,
"uri": "http://pasture-one-actor/object/cU2ng5UF02A",
"url": "http://pasture-one-actor/object/cU2ng5UF02A",
"replies_count": 0,
"reblogs_count": 0,
"favourites_count": 0,
"favourited": false,
"reblogged": false,
"muted": false,
"bookmarked": false,
"pinned": false,
"content": "Multiple formats for video",
"reblog": null,
"account": {
"id": "01K3GV8459F044M7E2J13WTR56",
"username": "actor",
"acct": "actor@pasture-one-actor",
"display_name": "Test Actor",
"locked": true,
"discoverable": false,
"bot": false,
"created_at": "2025-08-25T14:48:51.133Z",
"note": "",
"url": "http://pasture-one-actor/actor",
"avatar": "http://gotosocial/assets/default_avatars/GoToSocial_icon5.png",
"avatar_static": "http://gotosocial/assets/default_avatars/GoToSocial_icon5.png",
"header": "http://gotosocial/assets/default_header.png",
"header_static": "http://gotosocial/assets/default_header.png",
"followers_count": 0,
"following_count": 0,
"statuses_count": 25,
"last_status_at": "2025-08-25T14:49:18.000Z",
"emojis": [],
"fields": []
},
"media_attachments": [],
"mentions": [
{
"id": "01KA518HV2YMVXQKRA76EF2ZJV",
"username": "cookie",
"url": "http://gotosocial/@cookie",
"acct": "cookie"
}
],
"tags": [],
"emojis": [],
"card": null,
"poll": null
}
hollo
{
"id": "0198ea98-9930-7531-b10e-d067ac0771d5",
"created_at": "2025-08-27T08:15:26.000Z",
"in_reply_to_id": null,
"sensitive": false,
"spoiler_text": "",
"visibility": "public",
"language": null,
"uri": "http://pasture-one-actor/object/g8TmVfctZHs",
"url": "http://pasture-one-actor/object/g8TmVfctZHs",
"replies_count": 0,
"reblogs_count": 0,
"favourites_count": 0,
"favourited": false,
"reblogged": false,
"muted": false,
"bookmarked": false,
"pinned": false,
"content": "Multiple formats for video",
"reblog": null,
"quote_id": null,
"quote": null,
"application": null,
"account": {
"id": "0198ea98-1daf-74ca-ab5b-29bdfc9e43ad",
"username": "actor",
"acct": "actor@pasture-one-actor",
"display_name": "Test Actor",
"locked": false,
"bot": false,
"created_at": "2025-08-27T08:14:54.323Z",
"note": "",
"url": "http://pasture-one-actor/actor",
"avatar": "http://hollo/image/avatars/original/missing.png",
"avatar_static": "http://hollo/image/avatars/original/missing.png",
"header": "http://hollo/image/headers/original/missing.png",
"header_static": "http://hollo/image/headers/original/missing.png",
"followers_count": 0,
"following_count": 0,
"statuses_count": 0,
"moved": null,
"last_status_at": null,
"emojis": [],
"fields": []
},
"media_attachments": [
{
"id": "0198ea98-9c33-7037-b50b-34679b0cc23a",
"type": "video",
"url": "http://pasture-one-actor/assets/cow_eating.mp4",
"preview_url": "http://pasture-one-actor/assets/cow_eating.mp4",
"remote_url": null,
"text_url": null,
"meta": {
"original": {
"width": 512,
"height": 512,
"size": "512x512",
"aspect": 1
},
"small": {
"width": 512,
"height": 512,
"size": "512x512",
"aspect": 1
},
"focus": {
"x": 0,
"y": 0
}
},
"description": null,
"blurhash": null
}
],
"mentions": [],
"tags": [],
"card": null,
"emojis": [],
"emoji_reactions": [],
"poll": null,
"filtered": null
}