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",
"https://www.w3.org/ns/credentials/v2",
{
"size": "https://joinpeertube.org/ns#size"
}
],
"type": "Create",
"actor": "http://pasture-one-actor/actor",
"to": [
"http://mitra/users/admin",
"https://www.w3.org/ns/activitystreams#Public"
],
"id": "http://pasture-one-actor/activity/-Rj1kFN5yY8",
"published": "2025-08-30T19:41:15Z",
"object": {
"type": "Note",
"attributedTo": "http://pasture-one-actor/actor",
"to": [
"https://www.w3.org/ns/activitystreams#Public",
"http://mitra/users/admin"
],
"id": "http://pasture-one-actor/object/RA3tYnE_C9E",
"published": "2025-08-30T19:41:15Z",
"@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
}
]
}
}
mitra
{
"id": "0198fc7f-93fb-c7f1-f444-f2e0321a1723",
"uri": "http://pasture-one-actor/object/RA3tYnE_C9E",
"url": "http://pasture-one-actor/object/RA3tYnE_C9E",
"created_at": "2025-08-30T19:41:15.000Z",
"edited_at": null,
"account": {
"id": "0198fc7e-c86c-4794-ff91-849511c2819a",
"username": "actor",
"acct": "actor@pasture-one-actor",
"actor_id": "http://pasture-one-actor/actor",
"url": "http://pasture-one-actor/actor",
"display_name": "Test Actor",
"created_at": "2025-08-30T19:40:24.044Z",
"note": "",
"avatar": "http://mitra/api/v1/accounts/identicon?input=http://pasture-one-actor/actor",
"header": "http://mitra/api/v1/accounts/identicon",
"locked": false,
"mention_policy": "none",
"bot": false,
"identity_proofs": [],
"payment_options": [],
"fields": [],
"emojis": [],
"followers_count": 0,
"following_count": 0,
"subscribers_count": 0,
"statuses_count": 35,
"source": null,
"role": null,
"authentication_methods": null,
"client_config": null
},
"content": "Recommended Image Format",
"language": null,
"in_reply_to_id": null,
"in_reply_to_account_id": null,
"reblog": null,
"visibility": "public",
"sensitive": false,
"spoiler_text": "",
"pinned": false,
"replies_count": 0,
"favourites_count": 0,
"reblogs_count": 0,
"poll": null,
"media_attachments": [
{
"id": "0198fc7f-93f7-ab45-02e1-7d605dd279f3",
"type": "image",
"url": "http://mitra/media/6e403ee33c2817a06af46b6e362c054aec3b43057ff32d2f7ac7761761e6e1ff.jpg",
"preview_url": "http://mitra/media/6e403ee33c2817a06af46b6e362c054aec3b43057ff32d2f7ac7761761e6e1ff.jpg",
"description": "A beautiful cow"
}
],
"quote": null,
"mentions": [
{
"id": "0198fc7d-556c-6206-a6af-7434c71ae20f",
"username": "admin",
"acct": "admin",
"url": "http://mitra/users/admin"
}
],
"tags": [],
"emojis": [],
"favourited": false,
"reblogged": false,
"bookmarked": false,
"pleroma": {
"emoji_reactions": [],
"in_reply_to_account_acct": null,
"parent_visible": true,
"quote": null,
"quote_visible": true
},
"hidden": false,
"ipfs_cid": null,
"links": []
}
Example 2¶
activity
{
"@context": [
"https://www.w3.org/ns/activitystreams",
"https://www.w3.org/ns/credentials/v2",
{
"size": "https://joinpeertube.org/ns#size"
}
],
"type": "Create",
"actor": "http://pasture-one-actor/actor",
"to": [
"http://mitra/users/admin",
"https://www.w3.org/ns/activitystreams#Public"
],
"id": "http://pasture-one-actor/activity/uJS9bEZ1824",
"published": "2025-08-30T19:41:16Z",
"object": {
"type": "Note",
"attributedTo": "http://pasture-one-actor/actor",
"to": [
"https://www.w3.org/ns/activitystreams#Public",
"http://mitra/users/admin"
],
"id": "http://pasture-one-actor/object/ksuKr6Gy8pE",
"published": "2025-08-30T19:41:16Z",
"@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"
}
]
}
}
mitra
{
"id": "0198fc7f-99ea-0969-97cd-2509e19dc855",
"uri": "http://pasture-one-actor/object/ksuKr6Gy8pE",
"url": "http://pasture-one-actor/object/ksuKr6Gy8pE",
"created_at": "2025-08-30T19:41:16.000Z",
"edited_at": null,
"account": {
"id": "0198fc7e-c86c-4794-ff91-849511c2819a",
"username": "actor",
"acct": "actor@pasture-one-actor",
"actor_id": "http://pasture-one-actor/actor",
"url": "http://pasture-one-actor/actor",
"display_name": "Test Actor",
"created_at": "2025-08-30T19:40:24.044Z",
"note": "",
"avatar": "http://mitra/api/v1/accounts/identicon?input=http://pasture-one-actor/actor",
"header": "http://mitra/api/v1/accounts/identicon",
"locked": false,
"mention_policy": "none",
"bot": false,
"identity_proofs": [],
"payment_options": [],
"fields": [],
"emojis": [],
"followers_count": 0,
"following_count": 0,
"subscribers_count": 0,
"statuses_count": 36,
"source": null,
"role": null,
"authentication_methods": null,
"client_config": null
},
"content": "Recommended Video Attachment",
"language": null,
"in_reply_to_id": null,
"in_reply_to_account_id": null,
"reblog": null,
"visibility": "public",
"sensitive": false,
"spoiler_text": "",
"pinned": false,
"replies_count": 0,
"favourites_count": 0,
"reblogs_count": 0,
"poll": null,
"media_attachments": [
{
"id": "0198fc7f-99e5-a774-6c28-2f9aed0da6a4",
"type": "video",
"url": "http://mitra/media/4514a0bf67069eb36444ace0c4d5d6d4b95be4f01490e6a22ada67bbc3967d0e.mp4",
"preview_url": "http://mitra/media/4514a0bf67069eb36444ace0c4d5d6d4b95be4f01490e6a22ada67bbc3967d0e.mp4",
"description": "A beautiful cow eating"
}
],
"quote": null,
"mentions": [
{
"id": "0198fc7d-556c-6206-a6af-7434c71ae20f",
"username": "admin",
"acct": "admin",
"url": "http://mitra/users/admin"
}
],
"tags": [],
"emojis": [],
"favourited": false,
"reblogged": false,
"bookmarked": false,
"pleroma": {
"emoji_reactions": [],
"in_reply_to_account_acct": null,
"parent_visible": true,
"quote": null,
"quote_visible": true
},
"hidden": false,
"ipfs_cid": null,
"links": []
}
Example 3¶
activity
{
"@context": [
"https://www.w3.org/ns/activitystreams",
"https://www.w3.org/ns/credentials/v2",
{
"size": "https://joinpeertube.org/ns#size"
}
],
"type": "Create",
"actor": "http://pasture-one-actor/actor",
"to": [
"http://mitra/users/admin",
"https://www.w3.org/ns/activitystreams#Public"
],
"id": "http://pasture-one-actor/activity/Tzd0sTAQmtk",
"published": "2025-08-30T19:41:18Z",
"object": {
"type": "Note",
"attributedTo": "http://pasture-one-actor/actor",
"to": [
"https://www.w3.org/ns/activitystreams#Public",
"http://mitra/users/admin"
],
"id": "http://pasture-one-actor/object/6T8qKTzQNxE",
"published": "2025-08-30T19:41:18Z",
"@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"
}
]
}
}
mitra
{
"id": "0198fc7f-9fa8-e68e-a9a3-16dbe50f0e20",
"uri": "http://pasture-one-actor/object/6T8qKTzQNxE",
"url": "http://pasture-one-actor/object/6T8qKTzQNxE",
"created_at": "2025-08-30T19:41:18.000Z",
"edited_at": null,
"account": {
"id": "0198fc7e-c86c-4794-ff91-849511c2819a",
"username": "actor",
"acct": "actor@pasture-one-actor",
"actor_id": "http://pasture-one-actor/actor",
"url": "http://pasture-one-actor/actor",
"display_name": "Test Actor",
"created_at": "2025-08-30T19:40:24.044Z",
"note": "",
"avatar": "http://mitra/api/v1/accounts/identicon?input=http://pasture-one-actor/actor",
"header": "http://mitra/api/v1/accounts/identicon",
"locked": false,
"mention_policy": "none",
"bot": false,
"identity_proofs": [],
"payment_options": [],
"fields": [],
"emojis": [],
"followers_count": 0,
"following_count": 0,
"subscribers_count": 0,
"statuses_count": 37,
"source": null,
"role": null,
"authentication_methods": null,
"client_config": null
},
"content": "Recommended Audio Format",
"language": null,
"in_reply_to_id": null,
"in_reply_to_account_id": null,
"reblog": null,
"visibility": "public",
"sensitive": false,
"spoiler_text": "",
"pinned": false,
"replies_count": 0,
"favourites_count": 0,
"reblogs_count": 0,
"poll": null,
"media_attachments": [
{
"id": "0198fc7f-9fa4-0b78-b92d-67a03990f68a",
"type": "audio",
"url": "http://mitra/media/3e33fee4c40cdc62e2744d8cf9b7b65b97e0af17e81170b067a1b8fe49b88f28.m2a",
"preview_url": "http://mitra/media/3e33fee4c40cdc62e2744d8cf9b7b65b97e0af17e81170b067a1b8fe49b88f28.m2a",
"description": "A cow mooing"
}
],
"quote": null,
"mentions": [
{
"id": "0198fc7d-556c-6206-a6af-7434c71ae20f",
"username": "admin",
"acct": "admin",
"url": "http://mitra/users/admin"
}
],
"tags": [],
"emojis": [],
"favourited": false,
"reblogged": false,
"bookmarked": false,
"pleroma": {
"emoji_reactions": [],
"in_reply_to_account_acct": null,
"parent_visible": true,
"quote": null,
"quote_visible": true
},
"hidden": false,
"ipfs_cid": null,
"links": []
}
Example 4¶
activity
{
"@context": [
"https://www.w3.org/ns/activitystreams",
"https://www.w3.org/ns/credentials/v2",
{
"size": "https://joinpeertube.org/ns#size"
}
],
"type": "Create",
"actor": "http://pasture-one-actor/actor",
"to": [
"http://mitra/users/admin",
"https://www.w3.org/ns/activitystreams#Public"
],
"id": "http://pasture-one-actor/activity/FMoqBxzNIcg",
"published": "2025-08-30T19:41:19Z",
"object": {
"type": "Note",
"attributedTo": "http://pasture-one-actor/actor",
"to": [
"https://www.w3.org/ns/activitystreams#Public",
"http://mitra/users/admin"
],
"id": "http://pasture-one-actor/object/w6RwnpokZq0",
"published": "2025-08-30T19:41:19Z",
"@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"
}
]
}
}
mitra
{
"id": "0198fc7f-a581-2e83-1364-ff45992577e3",
"uri": "http://pasture-one-actor/object/w6RwnpokZq0",
"url": "http://pasture-one-actor/object/w6RwnpokZq0",
"created_at": "2025-08-30T19:41:19.000Z",
"edited_at": null,
"account": {
"id": "0198fc7e-c86c-4794-ff91-849511c2819a",
"username": "actor",
"acct": "actor@pasture-one-actor",
"actor_id": "http://pasture-one-actor/actor",
"url": "http://pasture-one-actor/actor",
"display_name": "Test Actor",
"created_at": "2025-08-30T19:40:24.044Z",
"note": "",
"avatar": "http://mitra/api/v1/accounts/identicon?input=http://pasture-one-actor/actor",
"header": "http://mitra/api/v1/accounts/identicon",
"locked": false,
"mention_policy": "none",
"bot": false,
"identity_proofs": [],
"payment_options": [],
"fields": [],
"emojis": [],
"followers_count": 0,
"following_count": 0,
"subscribers_count": 0,
"statuses_count": 38,
"source": null,
"role": null,
"authentication_methods": null,
"client_config": null
},
"content": "Multiple formats for video",
"language": null,
"in_reply_to_id": null,
"in_reply_to_account_id": null,
"reblog": null,
"visibility": "public",
"sensitive": false,
"spoiler_text": "",
"pinned": false,
"replies_count": 0,
"favourites_count": 0,
"reblogs_count": 0,
"poll": null,
"media_attachments": [],
"quote": null,
"mentions": [
{
"id": "0198fc7d-556c-6206-a6af-7434c71ae20f",
"username": "admin",
"acct": "admin",
"url": "http://mitra/users/admin"
}
],
"tags": [],
"emojis": [],
"favourited": false,
"reblogged": false,
"bookmarked": false,
"pleroma": {
"emoji_reactions": [],
"in_reply_to_account_acct": null,
"parent_visible": true,
"quote": null,
"quote_visible": true
},
"hidden": false,
"ipfs_cid": null,
"links": []
}