How to attach file to a GitHub issue?

Question

I migrated with a project from Bitbucket to GitHub and I cannot find a way to attach a file to an issue (ex: screenshot, specs, etc).

How to do it?

Ok, the solution I found to fit me is: Keep the main repo on Bitbucket and make a mirror on Github (sorry Github) and also point all (eventually) Github issues to the Bitbucket counterpart. — Alex, Aug 09 '12 at 13:04
A nice way to get screenshots attached to issues is [Usersnap](https://usersnap.com/connect/github) - you can send screenshots with annotations directly from within your web app to GitHub Issues! — Gregor, Jul 01 '14 at 14:09
As of 11/03/2015 you can now upload these types of files to github without any extension or plug-in: PNG, GIF, JPG, DOCX, PPTX, XLSX, TXT, or PDF — jfountain, Nov 05 '15 at 21:54
Also accepts ZIP and GZ, which is handy for reproducers: https://help.github.com/articles/file-attachments-on-issues-and-pull-requests/ — Vsevolod Golovanov, Feb 02 '16 at 13:40
It's kind of shameful that we cannot add movies describing bugs to our issues on Github. — Jonny, Jun 21 '17 at 02:19

score 255 · Accepted Answer · edited Jan 18 '21 at 00:04

255

~~You upload it somewhere and add the link in a comment. GitHub's Issues is rather primitive and doesn't allow attaching files.~~

Update: You can post images to GitHub issues now. The easiest way is to copy the image (right click, Copy image) and then paste it into the text box where you describe the issue.

OR

Just drag and drop

edited Jan 18 '21 at 00:04

101

8,514
6
43
69

answered Jun 09 '12 at 17:53

Dominik Honnef

17,937
7
41
43

94

Oh God, I was afraid of this answer :) – Alex Jun 09 '12 at 18:36
18

One easy place to do the upload is Github's own Gist service: https://gist.github.com/ – bjnord Sep 29 '12 at 14:17
6

This answer should probably be updated as Github now allows you to upload images for commets. – masukomi Feb 05 '13 at 23:41
2

Unfortunately, Github doesn't allow upload of PDFs :( – Mar 18 '13 at 02:32
2

Got so excited about copy paste but it didn't work for images (got [this](https://cloud.githubusercontent.com/assets/1148376/4613386/2642505c-52d5-11e4-85e1-9691981b160d.png)) when copying from mac – Endless Oct 13 '14 at 12:34
i can prove that uploading with drad&drop works for me. Using OS X. – CodeGroover Nov 10 '14 at 19:30
@Alex Why did you afraid?! The number of votes on your comment make me curious to know! :) – Ebrahim Ghasemi Apr 08 '15 at 13:14
1

@Abraham My "afraid" comment was posted before Dominik updated his answer. I hope now makes sense. – Alex Apr 08 '15 at 13:53
@bjnord can you actually attach an image to a Gist? how u do that? – ivansabik Apr 08 '15 at 15:21
It would be great to add source code but I suppose you can use a gist for that. – Raffi Khatchadourian Jun 23 '15 at 15:00
@sampablokuper Github has added support for PDFs: https://imgur.com/UNogHDz (https://help.github.com/articles/file-attachments-on-issues-and-pull-requests/). Currently non-image attachments require write-access to the repository, "but there's also some discussion about lifting the permission restriction for non-image attachments" (according to Robert from Github support). – Rob W Oct 01 '15 at 14:12
Attaching PDF files no longer requires write-access to a Github repo. So you can now freely attach PDF files to issues. – Rob W Nov 11 '15 at 09:36
1

If the paste option does not occur, just drag and drop it. – Kshitij Dhyani Jan 13 '20 at 06:43
How would this work for private repos? Would the image be private as well? – Anis LOUNIS aka AnixPasBesoin Mar 08 '21 at 22:02
Is there a way to do it on the mobile website from a phone? – trebor Jun 20 '21 at 19:03
I have no way to copy the video, or drag & drop, is there a button for this? – DRKblade Jun 26 '22 at 20:03

score 45 · Answer 2 · answered Dec 08 '12 at 01:28

45

As of December 7, 2012, you can attach images by drag/drop or use a file chooser. See https://github.com/blog/1347-issue-attachments for more details.

answered Dec 08 '12 at 01:28

Tim Schaub

6,722
1
26
17

score 39 · Answer 3 · answered Apr 21 '18 at 05:25

39

To attach a file to an issue or pull request conversation, drag and drop it into the comment box.

The maximum size for files is 25MB and the maximum size for images is 10MB.

Upload Image

answered Apr 21 '18 at 05:25

Burhan Nasir

644
6
14

good answer. it's just markdown format. `![image](your_image_url)` – Siwei Oct 15 '18 at 01:35
6

But it also auto-uploads the file to GitHub for you. – serv-inc Feb 27 '19 at 06:33

jfountain · Answer 4 · 2015-11-05T21:54:10.597

17

ZenHub.io Chrome plug-in will enable you to add any type of file to a github issue. It's stored on ZenHub's AWS server instead of github.com. From their website...

GitHub only allows you to upload image files. ZenHub adds the ability to upload any type of file into issues and comments, transferring securely to Amazon S3. With this you can really take your workflow to the next level; try using GitHub for everything! Centralized collaboration and transparency are awesome.

Update:

As of 11/03/2015 you can now upload these types of files to github without any extension or plug-in: PNG, GIF, JPG, DOCX, PPTX, XLSX, TXT, or PDF

edited Nov 05 '15 at 21:54

answered Jul 24 '14 at 21:11

jfountain

3,715
2
24
22

I just can't fine the feature in ZenHub.io. would you please show how it is done? – Foad S. Farimani Jul 13 '17 at 00:13
They may have removed it as it supported by github without plug-ins now. – jfountain Jul 13 '17 at 21:36
so now we can attach any arbitrary files to a comment/issue? I just can't find it! – Foad S. Farimani Jul 13 '17 at 21:38

score 13 · Answer 5 · answered Jun 10 '12 at 06:44

As an illustration of the previous answers, see this comment:

I create a repository called catfood http://github.com/blueheadpublishing/catfood/ where I keep misc stuff (like screenshots and other attachments).
That way I can reference them in issues.

See https://github.com/blueheadpublishing/bookshop/issues/10

Some images showing the types of layout templates we want to have generated by templates:

Example One - Three Percentage Columns

Example Two - Two Percentage Columns Left

Example Three - Two Percentage Columns Right

Back in 2009, GitHub expressed the intent to add attachment to issues.

Attachments are something we'd like to add.

That topic wasn't raised since in the GitHub group though...

score 10 · Answer 6 · answered Nov 24 '12 at 19:11

10

The format for embedding images into a GitHub comment is:

Format:  ![Alt Text](url)
Example: ![GitHub Logo](/images/logo.png)

answered Nov 24 '12 at 19:11

Matt Faus

6,321
2
27
43

Thank you. An answer that doesn't require drag-and-drop. This is exactly what I needed. :) – teracow May 20 '17 at 20:45

score 2 · Answer 7 · answered Jun 02 '16 at 09:01

2

Use gist.github.com to upload any contents like code, log, html files etc. and share the link.

answered Jun 02 '16 at 09:01

Vivek Kulkarni

79
1
10

Its not clear how to use gist for that purpose. There is add file button, but it doesn't open attach window. – Stepan Yakovenko Apr 13 '17 at 16:56

VonC · Answer 8 · 2021-05-13T19:17:13.690

8 years later (Dec. 2020), you can not only drag and drop images to PR/issues, but also... videos!
And in May 2021, this is now generally available.

Video upload public beta

You can now upload .mp4 and .mov files to issue, pull request, and discussion comments to share reproduction steps, design ideas, and experience details with your team.

The public beta will gradually rollout to all GitHub accounts over the coming week.

richo · Answer 9 · 2012-06-10T10:54:50.830

1

It's a bit of a kludge but you could create a junk branch, then commit the file to that branch and purge it later.

EDIT: This script may be of use to you:

https://github.com/wereHamster/ghup

edited Jun 10 '12 at 10:54

answered Jun 09 '12 at 18:12

richo

8,717
3
29
47

score 1 · Answer 10 · answered Aug 09 '12 at 09:31

1

I found an easy way to embed images in issues using Skitch. Just set up Skitch sharing and auto-copy the URL to the clipboard. Then paste it in when writing up the issue. I blogged about it here.

answered Aug 09 '12 at 09:31

Dogweather

15,512
17
62
81

I heard about this. The reviews in the Mac app store are pretty bad for the new version. And it sounds like they might have removed the functionality to do this image embedding. – Dogweather Sep 23 '12 at 05:07

score 1 · Answer 11 · answered Feb 16 '15 at 19:19

One quick/easy hack is to upload your attachment (say PDF or Office doc) to Dropbox, then include the Dropbox URL in the Github issue.

Mildly easier than using S3; many organizations are already using Dropbox; and Dropbox has good support for viewing many documents inline in the browser already.

score 0 · Answer 12 · answered Dec 04 '12 at 15:36

OK, here's what I use for screenshots.

http://www.techsmith.com/jing.html

It's free, fast, automatically uploads the image and pastes a URL link to your clipboard which you can Ctrl-V into the GitHub issue instantly.

It was a big sigh of relief when I discovered this :)

score 0 · Answer 13 · answered Jan 08 '21 at 11:12

If your image is already uploaded to github, then you can attach raw link to issues. For example, if your image's location in github is:

https://github.com/Qlio/someproj/blob/master/assets/image.png

then you can can change blob to raw like this:

https://github.com/Qlio/someproj/raw/master/assets/image.png

and then you can use this link to show image:

![My cool Image](https://github.com/Qlio/someproj/raw/master/assets/image.png)

How to attach file to a GitHub issue?

13 Answers13

Video upload public beta

Linked