gh-attach

Use the gh CLI with the --attach flag, for example: gh issue create --attach ./screenshot.png, or gh issue comment 12 --attach ./screenshot.png. The file uploads to GitHub's user-attachments CDN and renders inline in the body.

Reference the local file path in the markdown body, such as , and pass the same path to --attach. The gh CLI rewrites that reference to the uploaded asset URL instead of appending the file at the end.

No. The --attach flag works on github.com and GitHub Enterprise Cloud, including ghe.com data-residency tenants, but GitHub Enterprise Server hosts are refused. You also need write, maintain, or admin permission on the repository.

GitHub only renders video from a bare URL that is the entire content of a paragraph. If the video embed appears mid-sentence or as a reference-style image, gh degrades it to a plain link or reports an error.

Images up to 10 MB are accepted in png, jpg, jpeg, gif, webp, and svg formats. Videos up to 100 MB are accepted in mp4, mov, and webm formats, though the account plan may impose a lower real video ceiling.

gh stops at the first failed file but still writes the body pointing at the files that uploaded successfully. Check the issue or PR to see what posted, then re-attach only the missing files, since uploads cannot be undone or deleted.