7002328555
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: Anne-Marie <102995847+am-stead@users.noreply.github.com>
135 lines
5.2 KiB
Markdown
135 lines
5.2 KiB
Markdown
---
|
|
title: Attaching files
|
|
intro: You can convey information by attaching a variety of file types to your issues and pull requests.
|
|
product: '{% data reusables.gated-features.markdown-ui %}'
|
|
redirect_from:
|
|
- /github/managing-your-work-on-github/managing-your-work-with-issues-and-pull-requests/file-attachments-on-issues-and-pull-requests
|
|
- /articles/issue-attachments
|
|
- /articles/file-attachments-on-issues-and-pull-requests
|
|
- /github/managing-your-work-on-github/file-attachments-on-issues-and-pull-requests
|
|
- /github/writing-on-github/working-with-advanced-formatting/attaching-files
|
|
versions:
|
|
fpt: '*'
|
|
ghes: '*'
|
|
ghec: '*'
|
|
topics:
|
|
- Pull requests
|
|
---
|
|
|
|
{% ifversion ghes %}
|
|
|
|
> [!WARNING]
|
|
> When you upload an image or video to a pull request or issue comment, or upload a file to a ticket in the {% data variables.contact.landing_page_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.
|
|
|
|
{% endif %}
|
|
|
|
{% ifversion fpt or ghec %}
|
|
|
|
> [!NOTE]
|
|
> For public repositories, uploaded files can be accessed without authentication. In the case of private and internal repositories, only people with access to the repository can view the uploaded files.
|
|
|
|
{% endif %}
|
|
|
|
To attach a file to an issue or pull request conversation, drag and drop it into the comment box.
|
|
Alternatively, you can click {% octicon "paperclip" aria-label="Attach files" %} below the issue comment box to browse, select, and add a file from your computer.
|
|
|
|
|
|
|
|
For a pull request, you can also click {% octicon "paperclip" aria-label="Attach files" %} in the formatting bar above the pull request comment box.
|
|
|
|
|
|
|
|
When you attach a file, it is uploaded immediately to {% data variables.product.github %} and the text field is updated to show the anonymized URL for the file. {% ifversion fpt or ghec %}For more information on anonymized URLs see [AUTOTITLE](/authentication/keeping-your-account-and-data-secure/about-anonymized-urls).{% endif %}
|
|
|
|
> [!NOTE]
|
|
> In many browsers, you can copy-and-paste images directly into the box.
|
|
|
|
The maximum file size is:
|
|
|
|
* 10MB for images and gifs{% ifversion fpt or ghec %}
|
|
* 10MB for videos uploaded to a repository owned by a user or organization on a free {% data variables.product.prodname_dotcom %} plan
|
|
* 100MB for videos uploaded to a repository owned by a user or organization on a paid {% data variables.product.prodname_dotcom %} plan{% elsif ghes %}
|
|
* 100MB for videos{% endif %}
|
|
* 25MB for all other files
|
|
|
|
> [!NOTE]
|
|
> To upload videos greater than 10MB to a repository owned by a user or organization on a paid {% data variables.product.prodname_dotcom %} 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`)
|
|
{%- ifversion svg-support %}
|
|
* SVG (`.svg`)
|
|
{%- endif %}
|
|
* 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 for uploads in issue comments, pull request comments, and discussion comments within repositories. This list of file types is also supported in organization discussions.
|
|
|
|
### Supported file types for uploads
|
|
|
|
#### Documents
|
|
|
|
* PDFs (`.pdf`)
|
|
* Microsoft Office documents (`.docx`, `.pptx`, `.xlsx`, `.xls`, `.xlsm`)
|
|
* OpenDocument formats (`.odt`, `.fodt`, `.ods`, `.fods`, `.odp`, `.fodp`, `.odg`, `.fodg`, `.odf`)
|
|
* Rich text and word processing files (`.rtf`, `.doc`)
|
|
|
|
#### Text and data files
|
|
|
|
* Plain text and markup (`.txt`, `.md`, `.copilotmd`)
|
|
* Data and tabular files (`.csv`, `.tsv`, `.log`, `.json`, `.jsonc`)
|
|
|
|
#### Development and code files
|
|
|
|
* Binary files (`.bin`)
|
|
* C files (`.c`)
|
|
* C# files (`.cs`)
|
|
* C++ files (`.cpp`)
|
|
* CSS files (`.css`)
|
|
* Diagrams (`.drawio`)
|
|
* Dump files (`.dmp`)
|
|
* HTML files (`.html`, `.htm`)
|
|
* Java files (`.java`)
|
|
* JavaScript files (`.js`)
|
|
* Jupyter notebooks (`.ipynb`)
|
|
* Patch files (`.patch`)
|
|
* PHP files (`.php`)
|
|
* Profiling files (`.cpuprofile`)
|
|
* Program database files (`.pdb`)
|
|
* Python files (`.py`)
|
|
* Shell scripts (`.sh`)
|
|
* SQL files (`.sql`)
|
|
* TypeScript files (`.ts`, `.tsx`)
|
|
* XML files (`.xml`)
|
|
* YAML files (`.yaml`, `.yml`)
|
|
|
|
> [!NOTE]
|
|
> If you use Linux and try to upload a `.patch` file, you will receive an error message. This is a known issue.
|
|
|
|
#### Archive and compressed files
|
|
|
|
* Archives and packages (`.zip`, `.gz`, `.tgz`)
|
|
|
|
#### Communication and logs
|
|
|
|
* Text and email files (`.debug`, `.msg`, `.eml`)
|
|
|
|
#### Images
|
|
|
|
* Bitmap and TIFF images (`.bmp`, `.tif`, `.tiff`)
|
|
|
|
#### Audio
|
|
|
|
* Audio files (`.mp3`, `.wav`)
|