Attaching files

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

Who can use this feature?

Markdown can be used in the GitHub web interface.

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, or if private mode is enabled. To keep sensitive media files private, serve them from a private network or server that requires authentication.

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

Screenshot of the issue comment box. The "Attach files" icon is outlined in orange.

For a pull request, you can also click in the formatting bar above the pull request comment box.

Screenshot of the pull request comment box. The "Attach files" icon is outlined in orange.

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.

Note

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

The maximum file size is:

  • 10MB for images and gifs
  • 100MB for videos
  • 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.

Supported file types

Image and media files

The following image and media file types are supported in all contexts.

  • PNG (.png)

  • GIF (.gif)

  • JPEG (.jpg, .jpeg)

  • 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.

Additional file types

The following file types are supported when uploading to issue and pull request comments in repositories.

  • PDFs (.pdf)

  • Microsoft Office documents (.docx, .pptx, .xlsx, .xls)

  • OpenDocument formats (.odt, .fodt, .ods, .fods, .odp, .fodp, .odg, .fodg, .odf)

  • Text and data files (.txt, .csv, .log, .md, .json, .jsonc)

  • Archive files (.zip, .gz, .tgz)

  • Development files (.patch, .cpuprofile, .dmp)

    Note

    If you use Linux and try to upload a .patch file, you will receive an error message. This is a known issue.