Skip to main content

Attaching files

You can convey information by attaching a variety of file types to your issues and pull requests.

Warning: When you upload an image or video to a pull request or issue comment, or upload a file to a ticket in the GitHub Support portal, anyone can view the anonymized URL without authentication, even if the pull request or issue is in a private repository. To keep sensitive media files private, serve them from a private network or server that requires authentication. For more information on anonymized URLs see "About anonymized URLs."

To attach a file to an issue or pull request conversation, drag and drop it into the comment box. Alternatively, you can click the bar at the bottom of the comment box to browse, select, and add a file from your computer.

Select attachments from computer

When you attach a file, it is uploaded immediately to GitHub and the text field is updated to show the anonymized URL for the file. For more information on anonymized URLs see "About anonymized URLs".

Tip: In many browsers, you can copy-and-paste images directly into the box.

The maximum file size is:

  • 10MB for images and gifs
  • 10MB for videos uploaded to a repository owned by a user or organization on a free GitHub plan
  • 100MB for videos uploaded to a repository owned by a user or organization on a paid GitHub plan
  • 25MB for all other files

Note: To upload videos greater than 10MB to a repository owned by a user or organization on a paid GitHub plan, you must either be an organization member or outside collaborator, or be on a paid plan.

We support these files:

  • PNG (.png)
  • GIF (.gif)
  • JPEG (.jpg, .jpeg)
  • SVG (.svg)
  • Log files (.log)
  • Microsoft Word (.docx), Powerpoint (.pptx), and Excel (.xlsx) documents
  • Text files (.txt)
  • PDFs (.pdf)
  • ZIP (.zip, .gz, .tgz)
  • Video (.mp4, .mov, .webm)

Note: Video codec compatibility is browser specific, and it's possible that a video you upload to one browser is not viewable on another browser. At the moment we recommend using h.264 for greatest compatibility.

Attachments animated GIF