How to Add Images to Github ReadMe

May 5, 2026·2 min read

In this article

Interactive demo
Step-by-step guide
FAQ
Similar tutorials

Made with Saltfish·Create your own

Here's how to add images to github readme in GitHub

Navigate to the repository you want to modify.
Locate the README section and select 'Add a README'.
Use the file attachment option by dragging, dropping, selecting, or pasting your images.
Wait for the image to upload and appear in the editor.
Write a descriptive commit message explaining what you've added.
Include an extended description providing more context about your changes.
Click 'Commit changes' to save your README with the new images.

Ready to get started with
interactive demos?

Try for free

Frequently Asked Questions

What image formats are supported in GitHub README files?

GitHub supports common image formats including PNG, JPG, JPEG, GIF, and WebP. PNG and JPG are the most widely used formats for README files. Animated GIFs are also supported and can be great for demonstrating functionality.

Is there a file size limit for images uploaded to GitHub?

Yes, GitHub has a 25 MB limit for individual files uploaded through the web interface. For README images, it's recommended to keep file sizes under 1 MB for faster loading. You can compress images before uploading to reduce file size while maintaining quality.

Can I organize images in folders within my GitHub repository?

Absolutely! You can create folders like 'images' or 'assets' to organize your files. When referencing images in your README, you'll need to include the folder path in the image URL. This keeps your repository clean and well-structured.

How to Add Images to Github ReadMe

Here's how to add images to github readme in GitHub

Frequently Asked Questions

Similar tutorials

How to Connect GitHub to Visual Studio Code

How to Change Github Password

How to See Commit History in Github