Sometimes it’s easier to show than tell. We’re sure this update will help with that.

GitHub CLI now has a repeatable –attach flag that uploads a local image or video. Reference it inline in an issue, pull request, or comment body.

Available now to all users on GitHub across all plans. https://github.blog/changelog/2026-09-01-github-cli-media-in-issues-pull-requests-and-comments/…

GitHub CLI: Media in issues, pull requests, and comments

Source: https://github.blog/changelog/2026-09-01-github-cli-media-in-issues-pull-requests-and-comments/ GitHub CLI now has a repeatable\-\-attachflag that uploads a local image or video and references it inline in an issue, pull request, or comment body.

This is now generally available to all users on GitHub across all plans. You just need to updateghto v2.99.0.

Why this matters?

Some things are easier to show than to describe (i.e., a UI bug, a rendered result, an error on screen). Previously,ghonly wrote text, so adding an image or video to an issue or pull request meant stopping to open the browser, drag the file into the comment box, and copy the result back. Now,ghcan attach images and videos directly from the command line.

\-\-attachputs the image in the same command that writes Markdown. File the bug, and the screenshot lands with it, so the issue shows the actual problem the first time. Open the pull request with a before and after, and the reviewer sees the change instead of pulling the branch to check. Your coding agents get this too, so they can show a result rather than describe it.

Capabilities

• Attach from commands that write Markdown text:\-\-attachis repeatable and works ongh issue create,gh issue edit,gh issue comment,gh pr create,gh pr edit, andgh pr comment.
• **Keep your Markdown as written:**A local path already referenced in the body is rewritten in place, so\!\[alt\]\(\./login\.png\)keeps its alt text and becomes the uploaded asset. Anything attached but never referenced is appended at the end.
• **Post images and video:**PNG, JPEG, GIF, WebP, SVG, MP4, MOV, and WebM are all supported.
• **Describe what you attach:**Alt text follows the path after\#, as in\-\-attach '\./login\.png\#The login error state'. Omit it andghfalls back to the filename.

Security and access controls

Uploads authenticate with the common token typesghalready uses, either the OAuth token fromgh auth loginor a classic personal access token. Write access to the repository you are attaching to is required for image uploading.

\-\-attachis generally available to all users on GitHub across all plans, with no preview period. Size limits match the web upload flow: 10 MB for images and GIFs, 10 MB for video on Free plans, and 100 MB for video on paid plans. GitHub Enterprise Server is not supported in this release.

Getting started

Updateghto v2.99.0, then rungh issue comment \-\-attach \./screenshot\.png.\-\-attachworks the same way ongh issueandgh prcreate, edit, and comment. Rungh helpfor the full flag reference.

Join the discussionon the GitHub Community andread the docsto learn more about attaching files from the command line.

Editor’s note (September 1, 2026): Updated the doc link.