Bootstrap Images
Bootstrap makes images responsive and easy to style with a handful of utility classes. This lesson covers responsive scaling, shape, and alignment options for images.
Bootstrap Images Overview
The .img-fluid class applies max-width: 100% and height: auto so images scale down within their parent container instead of overflowing on small screens. This single class solves most responsive image problems without media queries.
Beyond responsiveness, Bootstrap provides shape utilities like rounded, rounded-circle, and img-thumbnail for bordered previews, along with shadow utilities and standard alignment helpers for positioning images inside text or layouts.
| Concept | Description | Common Usage |
| .img-fluid | max-width: 100%, height: auto | Making images scale within their container |
| .img-thumbnail | Adds border, padding, and rounded corners | Gallery previews, product thumbnails |
| .rounded / .rounded-circle | Rounds corners or makes an image circular | Avatars, profile pictures |
| Shadow utilities | shadow, shadow-sm, shadow-lg on images | Adding depth to featured images |
| Figure component | figure/figure-img/figure-caption | Images with captions |
Bootstrap Images Example
<img src="hero.jpg" class="img-fluid rounded shadow-sm" alt="Responsive hero image">
<img src="avatar.jpg" class="rounded-circle" width="64" height="64" alt="User avatar">
<img src="preview.jpg" class="img-thumbnail" alt="Thumbnail preview">
The first image scales responsively, gains rounded corners, and a subtle shadow for depth. The avatar example uses rounded-circle with explicit width and height for a consistent circular profile image. The thumbnail example adds a bordered, padded frame commonly used in galleries.
Top 10 Bootstrap Images Examples
These are the image utility patterns you'll use most often for responsive, styled images.
| # | Example | Syntax |
| 1 | Responsive image | <img src="a.jpg" class="img-fluid" alt="..."> |
| 2 | Thumbnail image | <img src="a.jpg" class="img-thumbnail" alt="..."> |
| 3 | Rounded corners | <img src="a.jpg" class="rounded" alt="..."> |
| 4 | Circular avatar | <img src="a.jpg" class="rounded-circle" alt="..."> |
| 5 | Image with shadow | <img src="a.jpg" class="img-fluid shadow" alt="..."> |
| 6 | Centered image | <img src="a.jpg" class="img-fluid mx-auto d-block" alt="..."> |
| 7 | Float-start image in text | <img src="a.jpg" class="float-start me-3" alt="..."> |
| 8 | Object-fit cover image | <img src="a.jpg" class="w-100 h-100 object-fit-cover" alt="..."> |
| 9 | Figure with caption | <figure class="figure"><img src="a.jpg" class="figure-img img-fluid rounded" alt="..."><figcaption class="figure-caption">Caption</figcaption></figure> |
| 10 | Grayscale-style border image | <img src="a.jpg" class="img-fluid border border-2" alt="..."> |
Popular Real-World Bootstrap Images Examples
These image patterns show up constantly in profiles, galleries, articles, and marketing pages.
| Scenario | Pattern |
| User profile avatar | <img src="user.jpg" class="rounded-circle" width="48" height="48" alt="User"> |
| Responsive blog cover image | <img src="cover.jpg" class="img-fluid rounded mb-3" alt="Cover"> |
| Product thumbnail grid | <img src="product.jpg" class="img-thumbnail" alt="Product"> |
| Team member photo | <img src="member.jpg" class="rounded-circle shadow-sm" width="120" alt="Team member"> |
| Hero background image inside card | <img src="hero.jpg" class="card-img-top" alt="Hero"> |
| Article inline image with text wrap | <img src="inline.jpg" class="float-md-end ms-md-3 img-fluid" alt="Inline"> |
| Logo centered in navbar brand | <img src="logo.svg" class="d-inline-block align-text-top" height="24" alt="Logo"> |
| Uniform card image cropping | <img src="a.jpg" class="w-100 object-fit-cover" style="height: 200px;" alt="..."> |
Best Practices
- Always add .img-fluid to images inside flexible layouts so they never overflow their container.
- Provide meaningful alt text for accessibility, never leaving it empty unless the image is purely decorative.
- Use explicit width and height attributes alongside responsive classes to reduce layout shift while loading.
- Prefer object-fit-cover with a fixed height for consistent card image cropping instead of stretching images.
- Use rounded-circle only with square source images, or the crop will look distorted.
- Combine shadow utilities sparingly; too many shadowed images reduce visual hierarchy.
- Use the figure component when an image needs an associated caption for context.
Common Mistakes
- Forgetting .img-fluid, causing large images to overflow their container on mobile.
- Leaving alt attributes empty or filled with filenames instead of descriptive text.
- Applying rounded-circle to non-square images without cropping first, producing an oval instead of a circle.
- Not setting explicit dimensions, causing layout shift as images load.
- Stretching images with width and height percentages instead of using object-fit utilities.
- Overusing img-thumbnail borders on images that already have a card border, doubling the frame.
Key Takeaways
- .img-fluid is the single most useful class for responsive images in Bootstrap.
- Shape utilities like rounded and rounded-circle style image corners without custom CSS.
- img-thumbnail adds a bordered, padded frame ideal for galleries.
- object-fit-cover combined with a fixed height keeps card image grids visually consistent.
- The figure component pairs images with semantic captions.
Pro Tip
For card grids with mixed image aspect ratios, set a fixed height on the image and add object-fit-cover instead of relying on img-fluid alone, so every card in the grid stays visually aligned.