goglobalwithtwitterbanner

Media Studio Library

The Library is Media Studio’s home page, where you can scroll through your media library, search your content, filter (by media type), upload new media, edit metadata, review analytics, and much more.

Here you will be able to see all your videos, GIFs, and image assets that you’ve shared from your Twitter account. This includes media assets that are Tweeted directly from your account and/or that are uploaded via Media Studio.

Library upload specifications

  • Video
  • Image
  • GIF

Uploading media

  • How to upload media to your Library
  • FAQs
  • Errors

Metadata and Content settings

  • How to modify media metadata
  • FAQs
  • Errors

Tweeting and scheduling Tweets

  • How to Tweet media from your Library
  • How to schedule a Tweet from your Library
  • FAQs
  • Errors

Media Sharing

  • How to share media from your Library to another Twitter account
  • How to manage media that has been shared via Media Studio
  • FAQs

Subtitles

  • How to upload an .srt subtitle file in Media Studio
  • Formatting
  • FAQs
  • Errors
 

Library upload specifications

These instructions are only valid for Media Studio, and should not be followed for usage of the Twitter developer API, Pro Media API, desktop upload, or mobile upload. 

You can upload images, GIFs, and videos into your media library. Additionally, all media that has been uploaded or attached to Tweets created via the desktop or mobile Twitter apps will appear in your library.

Video

File size and type
Maximum file size: 1 GB
Type: .MP4, .MOV

Resolution
Recommended resolution (landscape): 1280x720
Recommended resolution (square): 720x720

Encoding
Video specification: AVC encoding (H264)
Recommended video bitrate: 5-8 mbps
Maximum video framerate: 60 FPS
Audio specification: stereo/mono AAC (LC)
Subtitles: CEA 608/708 embedded, .SRT sidecar

Duration
Most people are limited to 2:20 (140 seconds), though some partners are allowlisted to allow for video duration up to 10 minutes.
If you would be like to be allowlisted for upload > 2:20 minute video uploads (up to 10 mins), reach out to your Twitter account manager.

Image

File size and type
Maximum file size: 20 MB
File type: .JPG, .PNG

Resolution
Maximum resolution: 8192x8192

GIF

File size
Maximum file size: 15 MB
File type: .GIF

Resolution
Maximum resolution: 2048x2048

 

Uploading media

How to upload media to your library

  1. Ensure you’re logged in and viewing studio.twitter.com.
  2. Click the Upload button at the top-right of the page.
  3. Select one or more media files from your computer.
  4. Once your media has been selected, upload will start automatically.

Tip: You may also drag and drop files into Media Studio.

Uploading media - FAQs

Can I upload multiple files at the same time?
Yes. When selecting media to upload from your computer, you can highlight multiple files to upload. Studio also has a drag-and-drop functionality, allowing you to upload files just by dragging the icons from your desktop or file manager to your Media Studio library.

Why can’t I select .mov files for upload?
If you are unable to select an .mov file via the file selection window, attempt to upload the file by dragging it into your Media Studio Library. 

Can I delete media from my library?
Yes, you can delete media from your library at any time. If you have previously Tweeted this media, people will see a playback error message. It is recommended that you delete these Tweets to ensure people do not see this message.

Can I filter the view of media within my library?
Currently we only support filtering the library view by media type.

Uploading media - Common errors and warnings

Error: ‘Video too long’
This error usually appears when you uploading media. Check to ensure your video is under 2:20 in duration (or 10 minutes, if you have been allowlisted for this feature by your Twitter account manager).

Error: ‘Upload failed’

Video
This error can appear for a few different issues: file size, resolution, encoding settings, or a connection issue. First ensure that your video file is 1GB or smaller in size—reducing the video bitrate of the file is the easiest solution for making a smaller file size. Next, ensure the resolution and encoding settings of your video are within our recommended specifications. Finally, if there is any packet loss or connection failure at the time of upload, the entire process will fail and need to be restarted.

Image and GIF
Ensure your file size, type, and resolution are within the recommended specifications. 

Processing: Stuck at 5%
It could take up to 30 minutes for your media file to complete processing. If the system cannot process the file within that timeframe, the upload will fail and the ‘Upload failed’ error message will appear.

This happens most often with .mov files. If possible, re-export files as .mp4, which should allow for overall faster upload and processing time.

 

Metadata and content settings

How to modify media metadata

  1. Click on the media you wish to modify within your Media Studio library.

  2. Click the Settings tab.

  3. You can update the following types of metadata (all optional):

    1. Title – updates the title field shown on some Twitter platforms.

    2. Description – updates the description field shown on some Twitter platforms.

    3. Call to action – adds a clickable/tappable URL to the video player shown on some Twitter platforms.

    4. Embedded Tweet playback – determines whether or not the video will play when a Tweet with your video is embedded on a third-party website, ensuring that users must view the video on Twitter.

  4. Open Content Restrictions if you need to enable video geo-restrictions:

    1. Include.

    2. Exclude.

Metadata and content settings - FAQs

How do I save any updates I make within Studio?
There is no save button within Studio – all changes and updates are automatically saved.

Can I edit the media I’ve uploaded to Media Studio? 
No, Media Studio does not currently have editing capabilities for any uploaded media. Clips created via LiveCut can be edited within LiveCut, however this will create a copy of the media and you would need to set any necessary metadata for the new version. 

Does the filename appear anywhere on Twitter?
No, the filename field in Media Studio is not shown anywhere publicly.

Where is the title and description of my video shown on Twitter? 
Once Tweeted, the title and description of your video will appear on the Tweet details page under the video player. It will not appear when the Tweet is viewed on the timeline.

Can I change thumbnails of my uploaded videos?
Yes. Click on a video within your library to see the Select thumbnail button. You can either select a frame from the video itself, or upload an image file from your local computer.

If uploading a custom thumbnail file from your computer, please ensure its aspect ratio is the same as your video content. Using a custom thumbnail that is a different size can cause issues with playback on Twitter.

Can I upload a custom image thumbnail for a video?
Yes. Click on an uploaded video within your library and then click the ‘Change thumbnail’ button. Here you have the option to either choose a frame from within the video or upload a custom image from your computer. This feature is not available on Safari.

What is the ‘How would you describe your video?’ field? How is that category used on Twitter?
This field is only required and used for videos being monetized in the Amplify Pre-roll program as a way to match your content with relevant advertisers. 

When the field is used for non-monetized, organic videos, the set category is neither used nor shown on Twitter.

What are content restrictions? What are geo-restrictions?

Enabling content restrictions on a video allows the viewing of the video to be limited to viewers in specified countries. Restrictions are set by either Including a list of countries allowed to view, or Excluding a list of countries not allowed to view the video. Keep in mind that there may be a delay when updating restrictions on a video that has already been Tweeted (approximately one to two minutes).

Can I add a geo-restricted piece of media to a thread?
Adding to threads from within Media Studio is not yet available, but here is a workaround. 

  1. Tweet out the geo-restricted video from Media Studio in its own Tweet (this Tweet could be made to be ‘Promoted only’ so that it will not be publicly viewable via your profile).

  2. On Twitter, create a reply within the thread and paste the URL of the geo-restricted video Tweet and append /video/1 to the end of the URL, that would look like this: twitter.com/handle/tweetid/video/1

Tweet and media analytics will be available via the Tweet Analytics Dashboard and/or the Video Analytics Dashboard (both found at analytics.twitter.com).

Am I able to modify any video metadata after Tweeting?
Modifications to geo-restrictions and subtitles settings will be applied to all Tweets in which the media is shared on Twitter, even retroactively. However, title, description, category, call-to-action, and embedding settings cannot be changed for an existing Tweet -- any changes made to these settings will be reflected in any new Tweets created with that media.

Metadata and content settings - Common errors and warnings

Error: 'valid URL must be provided’
This error message occurs when adding a call-to-action URL. Check for any invalid special characters in your URL, like vertical bars, spaces, or quotation marks.

Error: 'Error refreshing media'
This can happen if too many changes are made to metadata too quickly, causing Media Studio to have issues saving all of the changes at once. Refresh your browser window and attempt to make the changes again.

 

Tweeting and scheduling Tweets

How to Tweet media from your library

  1. Click the Tweet button underneath the media thumbnail.

  2. Within the Tweet compose window, enter your Tweet text (up to 280 characters).

  3. Click the Tweet button to immediately post your new Tweet.

Tip: if you would like to create a Tweet that does not appear on your timeline, select the checkbox marked ‘Promoted-only’. Find more information about Promoted-only Tweets.

How to schedule a Tweet from your library

  1. Click on the Tweet button underneath the media thumbnail.

  2. Within the Tweet compose window, enter your Tweet text (up to 280 characters).

  3. Click the Schedule button at the bottom of the dialog box.

  4. Within the date picker that appears, select both a date and exact time (shown with your current timezone).

  5. Click the Tweet button to save the scheduled Tweet.

  6. At your selected date and time, Media Studio will post your Tweet.

Tweeting and scheduling Tweets - FAQs

Can I create a Tweet with 280 characters?
Yes, Media Studio supports the creation of Tweets with up to 280 characters. This also applies to the Tweet scheduling feature in Media Studio.

Can I create Tweets from multiple usernames?
Yes, Media Studio supports the creation of multiple Tweets to various usernames at once. First ensure that you have access to Tweet on behalf of other usernames.

In the Tweet compose window, look for the dropdown next to your username listed at the top-left. Within the dropdown will be a list of all @usernames with which you can create Tweets. Select as many usernames as needed, and click the Tweet button.

Can I create a thread with multiple Tweets?
No, this feature is not supported in Media Studio today.

Can I schedule more than one Tweet at a time?
You can only schedule one Tweet at a time per account. If you have access to multiple accounts, you can schedule a Tweet to be sent from any or all of those accounts at the same time with the same Tweet content. 

Can I edit a scheduled Tweet?
No, it is not possible to edit a scheduled Tweet in Media Studio. If you need to make a change, delete the scheduled Tweet and create a new one.  Scheduled Tweets can be modified on Twitter.com, however this will create a new, lower-quality copy of the media and lose associated metadata set within Media Studio.

If you have access to a Twitter Ads account, you can edit scheduled Tweets from that dashboard under Creatives —> Tweets page.

How do I delete a scheduled Tweet created via Media Studio?
Click on the Schedule button within the top navigation bar. In this view, all of your scheduled Tweets will appear. Click the delete icon  next to any scheduled Tweets you would like to delete.

For Tweets that have already been posted to Twitter, you must delete these via Twitter on desktop or via the Twitter for iOS or Android app.

Tweeting and scheduling Tweets - Common errors and warnings

Error: ‘Tweeting failed for @user. Error - 3: Tweet is a duplicate.’
The Tweet is too similar to one already Tweeted. Tweak the Tweet copy slightly and there should be no issue sending the new Tweet. If you continue to face issues, please reach out to your account manager for assistance. If you do not have an account manager, you can file a support ticket here: https://help.twitter.com/forms.

Error: ‘Tweeting failed for @user. Error - 0: Internal server error'
Please reach out to your account manager for assistance. If you do not have an account manager, you can file a support ticket here: https://help.twitter.com/forms.

Error: ‘Scheduling failed for @user. Error - 2: Rate limit exceeded’
This error message can occur when creating a scheduled Tweet, and will appear when an account has reached the limit of 1000 draft or scheduled Tweets.

 

Media sharing

How to share media from your library to another Twitter account

  1. Click on a media within your Media Studio library.

  2. Click the Sharing tab.

  3. Start typing in the username of the person with which you would like to share the media.

  4. Click on the correct username that appears in the dropdown.

  5. If you need to remove shared access, click the delete icon next to the associated username.

How to manage media that has been shared via Media Studio

  1. Click on the dropdown  next to the Library header under the navigation bar.

  2. Click on Shared Media.

  3. Manage and create Tweets via shared media within this view.

Note: All Tweets created via this method will include attribution to the original owner of the video (the username that originally shared the video).

Media sharing - FAQs

Why isn’t an account appearing in the Sharing username search field?
Most commonly this occurs when the handle was just created; wait 24 hours and try searching for the username again. If after 24-hours the handle does not appear, please reach out to your account manager for assistance. If you do not have a account manager, you can file a support ticket here: https://help.twitter.com/forms

Is there a way to share a video without using the Media Studio share function?
Yes, if you take the URL of a Tweet, like the one below, you can append “/video/1” to the end. Pasting this URL at the end of a new Tweet will render a video player. In this new Tweet, we will surface ‘attribution’, or the name of the user that originally uploaded the video.

twitter.com/USERNAME/STATUS/TWEETID

twitter.com/USERNAME/STATUS/TWEETID/VIDEO/1

Can I bulk share to multiple handles at once? 
The sharing functionality happens via a typeahead function, this means that you can only enter one username at a time. There is no way to automatically share media across multiple usernames or copy/paste a bulk action. 

Does the username getting access to shared media receive any notification, email, or alert? 
No, users that have media shared with them will not receive a notification. They will see the media in their Shared Library when they next visit or refresh the page.

After sharing a piece of media, a ‘Shared link’ will appear at the bottom of the ‘Sharing’ tab. You can send this link to the recipient, which will prompt them to log into Media Studio with their Twitter account that you shared with in order to create a Tweet with the shared media.

 

Subtitles

How to upload an SRT subtitle file in Media Studio

  1. Click on a media within your Media Studio library.

  2. Click the Subtitles tab.

  3. Select the language of the SRT file.

  4. Click Upload.

  5. Select a subtitle file from your computer.

Subtitles - FAQs

How to format an .SRT subtitle file 
Follow the sample below for generating compatible subtitle files

1
00:00:06,000 --> 00:00:08,000
Hey, how's it going?

2
00:00:08,001 --> 00:00:10,000
What's up, how are you?

3
00:00:10,001 --> 00:00:11,000
Doing well, thanks!

Can I upload multiple subtitles per video?
Currently we only support one subtitle file uploaded per video.

Where do subtitles show on Twitter? 
When a video with subtitles is viewed on Twitter, the subtitles will appear as an overlay atop the video when the subtitles language matches the language set on the viewing user’s device (on desktop, the subtitles language is matched to the user’s Twitter language settings). If the subtitles language is not the same as the language of the user, subtitles will not appear. 

By default, subtitles appear when the video’s sound is not playing, and will be hidden when sound is playing. Some users may have subtitles enabled within their device’s accessibility settings—if this is the case, then subtitles will always show, regardless of whether audio is on or if full-screen view is in use.

I uploaded a subtitle, why doesn’t appear in the preview player in Media Studio?
Correct. Subtitle files will only be shown once Tweeted.

Subtitles - Common errors and warnings

Error: ‘There was a problem uploading your subtitle (.srt) file’
This means that there is likely an issue with the formatting of the file. Let’s use this below subtitle with incorrect formatting as an example:

22
0:00:36.801--> 0:00:42.239
Hey, how's it going?

21
00:00:40,161 --> 00:00:42,239
What's up, how are you?

Open the .SRT subtitle using your preferred text editing application and look for the following:

Chronology

Any end time needs to be before the next start time.
All subtitle headers need to be in chronological order.

Spaces

Remove any unnecessary spaces that appear before a time code.
Ensure there is one space before and one space after the "–>" in each time code.

Timestamp

A colon “:” is required between the hours, minutes, and seconds. 
A comma “,” is required between seconds and milliseconds.

Digits

Time codes must have double digits in all values for hours, minutes, and seconds.
Milliseconds need to have three digits.

Related Media Studio help

Overview
Library
Analytics
Producer
LiveCut
Monetize

Bookmark or share this article