Ratio
The ratio helper keeps a box at a fixed aspect ratio whatever its width, which is perfect for media placeholders, thumbnails, galleries and banners. Pick ratio-1x1, ratio-4x3, ratio-16x9 or ratio-21x9, or set any ratio with the --bs-aspect-ratio variable.
1The four built-in ratios
ratio-1x1, ratio-4x3, ratio-16x9 and ratio-21x9 next to each other, filled with a plain div.
<div class="row g-3">
<div class="col-6 col-md-3">
<div class="ratio ratio-1x1">
<div class="d-flex align-items-center justify-content-center bg-primary-subtle text-primary-emphasis border border-primary-subtle rounded fw-semibold">
1:1
</div>
</div>
</div>
<div class="col-6 col-md-3">
<div class="ratio ratio-4x3">
<div class="d-flex align-items-center justify-content-center bg-primary-subtle text-primary-emphasis border border-primary-subtle rounded fw-semibold">
4:3
</div>
</div>
</div>
<div class="col-6 col-md-3">
<div class="ratio ratio-16x9">
<div class="d-flex align-items-center justify-content-center bg-primary-subtle text-primary-emphasis border border-primary-subtle rounded fw-semibold">
16:9
</div>
</div>
</div>
<div class="col-6 col-md-3">
<div class="ratio ratio-21x9">
<div class="d-flex align-items-center justify-content-center bg-primary-subtle text-primary-emphasis border border-primary-subtle rounded fw-semibold">
21:9
</div>
</div>
</div>
</div>2Video placeholder
A 16:9 poster image with a centred play button, ready for a video player of your choice.
<div class="ratio ratio-16x9 rounded overflow-hidden" style="max-width:36rem">
<div>
<img src="https://images.unsplash.com/photo-1606318313647-137d1f3b4d3c?auto=format&fit=crop&w=1600&h=700&q=70" alt="Video poster" class="w-100 h-100 object-fit-cover">
<button type="button" class="btn btn-light rounded-circle position-absolute top-50 start-50 translate-middle shadow" aria-label="Play video"><i class="bi bi-play-fill" aria-hidden="true"></i></button>
</div>
</div>3Square product thumbnails
ratio-1x1 with object-fit-cover gives every product the same tile, whatever the photo size.
Teeth whitening
Braces consultation
Dental cleaning
Sports injury clinic
Skin check
Child check-up
<div class="row g-2">
<div class="col-4 col-md-2">
<div class="ratio ratio-1x1 rounded overflow-hidden border">
<img src="../assets/img/product-7.svg" alt="Teeth whitening" class="object-fit-cover">
</div>
<p class="small text-truncate mt-1 mb-0">Teeth whitening</p>
</div>
<div class="col-4 col-md-2">
<div class="ratio ratio-1x1 rounded overflow-hidden border">
<img src="../assets/img/product-12.svg" alt="Braces consultation" class="object-fit-cover">
</div>
<p class="small text-truncate mt-1 mb-0">Braces consultation</p>
</div>
<div class="col-4 col-md-2">
<div class="ratio ratio-1x1 rounded overflow-hidden border">
<img src="../assets/img/product-2.svg" alt="Dental cleaning" class="object-fit-cover">
</div>
<p class="small text-truncate mt-1 mb-0">Dental cleaning</p>
</div>
<div class="col-4 col-md-2">
<div class="ratio ratio-1x1 rounded overflow-hidden border">
<img src="../assets/img/product-10.svg" alt="Sports injury clinic" class="object-fit-cover">
</div>
<p class="small text-truncate mt-1 mb-0">Sports injury clinic</p>
</div>
<div class="col-4 col-md-2">
<div class="ratio ratio-1x1 rounded overflow-hidden border">
<img src="../assets/img/product-8.svg" alt="Skin check" class="object-fit-cover">
</div>
<p class="small text-truncate mt-1 mb-0">Skin check</p>
</div>
<div class="col-4 col-md-2">
<div class="ratio ratio-1x1 rounded overflow-hidden border">
<img src="../assets/img/product-9.svg" alt="Child check-up" class="object-fit-cover">
</div>
<p class="small text-truncate mt-1 mb-0">Child check-up</p>
</div>
</div>4Cinematic hero banner
ratio-21x9 for a wide banner with a headline overlay.
Personal care from people who listen
Friendly reminders make sure you never miss a check-up or a dose.
<div class="ratio ratio-21x9 rounded-3 overflow-hidden">
<div>
<img src="https://images.unsplash.com/photo-1758691462123-8a17ae95d203?auto=format&fit=crop&w=1600&h=700&q=70" alt="" class="w-100 h-100 object-fit-cover">
<div class="position-absolute bottom-0 start-0 p-3 p-md-4 text-white" style="background:rgba(0,0,0,.45)">
<h3 class="h4 mb-1">Personal care from people who listen</h3>
<p class="small mb-0 d-none d-sm-block">Friendly reminders make sure you never miss a check-up or a dose.</p>
</div>
</div>
</div>5Map placeholder
A 4:3 box reserved for a map, showing the address until the map loads.
<div class="ratio ratio-4x3" style="max-width:24rem">
<div class="d-flex flex-column align-items-center justify-content-center bg-body-tertiary border rounded text-center p-3">
<span class="fs-1 text-primary"><i class="bi bi-geo-alt-fill" aria-hidden="true"></i></span><strong>Solao Base</strong><span class="small text-body-secondary">51 Cedar Lane, Lisbon</span>
</div>
</div>6Custom 3:2 photo
Any ratio works with the --bs-aspect-ratio variable: 2 / 3 = 66.67% for classic photo prints.
<figure class="mb-0" style="max-width:28rem">
<div class="ratio rounded overflow-hidden" style="--bs-aspect-ratio:66.67%">
<img src="https://images.unsplash.com/photo-1581056771107-24ca5f033842?auto=format&fit=crop&w=1200&h=800&q=70" alt="Our favourite tips for busy weeks" class="object-fit-cover">
</div>
<figcaption class="small text-body-secondary mt-1">3:2 · The small habits that make a big difference</figcaption>
</figure>7Portrait team cards
A 3:4 portrait ratio (133.33%) for team photos in cards.
Owen Morgan
Project Manager
Sofia Ashford
Sales Executive
Leo Delgado
Backend Engineer
<div class="row g-3">
<div class="col-6 col-md-4">
<div class="card h-100">
<div class="ratio card-img-top overflow-hidden" style="--bs-aspect-ratio:133.33%">
<img src="https://images.unsplash.com/photo-1758691463331-2ac00e6f676f?auto=format&fit=crop&w=1200&h=800&q=70" alt="Owen Morgan" class="object-fit-cover">
</div>
<div class="card-body py-2">
<h3 class="h6 mb-0">Owen Morgan</h3>
<p class="small text-body-secondary mb-0">Project Manager</p>
</div>
</div>
</div>
<div class="col-6 col-md-4">
<div class="card h-100">
<div class="ratio card-img-top overflow-hidden" style="--bs-aspect-ratio:133.33%">
<img src="https://images.unsplash.com/photo-1758691462123-8a17ae95d203?auto=format&fit=crop&w=1200&h=800&q=70" alt="Sofia Ashford" class="object-fit-cover">
</div>
<div class="card-body py-2">
<h3 class="h6 mb-0">Sofia Ashford</h3>
<p class="small text-body-secondary mb-0">Sales Executive</p>
</div>
</div>
</div>
<div class="col-6 col-md-4">
<div class="card h-100">
<div class="ratio card-img-top overflow-hidden" style="--bs-aspect-ratio:133.33%">
<img src="https://images.unsplash.com/photo-1631217868264-e5b90bb7e133?auto=format&fit=crop&w=1200&h=800&q=70" alt="Leo Delgado" class="object-fit-cover">
</div>
<div class="card-body py-2">
<h3 class="h6 mb-0">Leo Delgado</h3>
<p class="small text-body-secondary mb-0">Backend Engineer</p>
</div>
</div>
</div>
</div>8Vertical stories
A 9:16 ratio (177.78%) for phone sized stories or short clips in a scrolling row.
<div class="d-flex gap-2 overflow-auto pb-1">
<div class="flex-shrink-0" style="width:7rem">
<div class="ratio rounded-3 overflow-hidden" style="--bs-aspect-ratio:177.78%">
<div>
<img src="https://images.unsplash.com/photo-1758691462878-6edc3d3da1be?auto=format&fit=crop&w=1200&h=800&q=70" alt="Story by Ravi Kowalski" class="w-100 h-100 object-fit-cover"><span class="position-absolute bottom-0 start-0 m-1 badge text-bg-dark">Ravi</span>
</div>
</div>
</div>
<div class="flex-shrink-0" style="width:7rem">
<div class="ratio rounded-3 overflow-hidden" style="--bs-aspect-ratio:177.78%">
<div>
<img src="https://images.unsplash.com/photo-1758691462123-8a17ae95d203?auto=format&fit=crop&w=1200&h=800&q=70" alt="Story by Lucas Ortega" class="w-100 h-100 object-fit-cover"><span class="position-absolute bottom-0 start-0 m-1 badge text-bg-dark">Lucas</span>
</div>
</div>
</div>
<div class="flex-shrink-0" style="width:7rem">
<div class="ratio rounded-3 overflow-hidden" style="--bs-aspect-ratio:177.78%">
<div>
<img src="https://images.unsplash.com/photo-1631217873436-b0fa88e71f0a?auto=format&fit=crop&w=1200&h=800&q=70" alt="Story by Theo Nguyen" class="w-100 h-100 object-fit-cover"><span class="position-absolute bottom-0 start-0 m-1 badge text-bg-dark">Theo</span>
</div>
</div>
</div>
<div class="flex-shrink-0" style="width:7rem">
<div class="ratio rounded-3 overflow-hidden" style="--bs-aspect-ratio:177.78%">
<div>
<img src="https://images.unsplash.com/photo-1758691462126-2ee47c8bf9e7?auto=format&fit=crop&w=1200&h=800&q=70" alt="Story by Mason Silva" class="w-100 h-100 object-fit-cover"><span class="position-absolute bottom-0 start-0 m-1 badge text-bg-dark">Mason</span>
</div>
</div>
</div>
</div>9Chart area
A 16:9 box that keeps a simple bar chart in proportion on every screen.
<div class="card" style="max-width:36rem">
<div class="card-header small fw-semibold">
Monthly bookings
</div>
<div class="card-body">
<div class="ratio ratio-16x9">
<div class="d-flex align-items-end gap-2" role="img" aria-label="Bar chart of monthly bookings">
<div class="flex-fill d-flex flex-column justify-content-end align-items-center h-100">
<div class="w-100 bg-primary rounded-top" style="height:47%">
</div>
<span class="small text-body-secondary">Jan</span>
</div>
<div class="flex-fill d-flex flex-column justify-content-end align-items-center h-100">
<div class="w-100 bg-primary rounded-top" style="height:52%">
</div>
<span class="small text-body-secondary">Feb</span>
</div>
<div class="flex-fill d-flex flex-column justify-content-end align-items-center h-100">
<div class="w-100 bg-primary rounded-top" style="height:26%">
</div>
<span class="small text-body-secondary">Mar</span>
</div>
<div class="flex-fill d-flex flex-column justify-content-end align-items-center h-100">
<div class="w-100 bg-primary rounded-top" style="height:37%">
</div>
<span class="small text-body-secondary">Apr</span>
</div>
<div class="flex-fill d-flex flex-column justify-content-end align-items-center h-100">
<div class="w-100 bg-primary rounded-top" style="height:46%">
</div>
<span class="small text-body-secondary">May</span>
</div>
<div class="flex-fill d-flex flex-column justify-content-end align-items-center h-100">
<div class="w-100 bg-primary rounded-top" style="height:44%">
</div>
<span class="small text-body-secondary">Jun</span>
</div>
<div class="flex-fill d-flex flex-column justify-content-end align-items-center h-100">
<div class="w-100 bg-primary rounded-top" style="height:22%">
</div>
<span class="small text-body-secondary">Jul</span>
</div>
<div class="flex-fill d-flex flex-column justify-content-end align-items-center h-100">
<div class="w-100 bg-primary rounded-top" style="height:86%">
</div>
<span class="small text-body-secondary">Aug</span>
</div>
</div>
</div>
</div>
</div>10Blog card cover
ratio-16x9 as a card image keeps every post card in a grid the same height.
How to choose the right service
Apr 5, 2026
<div class="card" style="max-width:22rem">
<div class="ratio ratio-16x9 card-img-top overflow-hidden">
<img src="https://images.unsplash.com/photo-1758691462123-8a17ae95d203?auto=format&fit=crop&w=1200&h=800&q=70" alt="When to choose a video consultation" class="object-fit-cover">
</div>
<div class="card-body">
<span class="badge text-bg-light border mb-2">tips</span>
<h3 class="h6">How to choose the right service</h3>
<p class="small text-body-secondary mb-0">Apr 5, 2026</p>
</div>
</div>11Caption over a gradient
A 4:3 image with a gradient overlay so white caption text stays readable.
<div class="ratio ratio-4x3 rounded-3 overflow-hidden" style="max-width:24rem">
<div>
<img src="https://images.unsplash.com/photo-1758691462126-2ee47c8bf9e7?auto=format&fit=crop&w=1200&h=800&q=70" alt="" class="w-100 h-100 object-fit-cover">
<div class="position-absolute bottom-0 w-100 p-3 text-white" style="background:linear-gradient(transparent,rgba(0,0,0,.7))">
<strong class="d-block">Vancouver</strong><span class="small">General practice</span>
</div>
</div>
</div>12Mixed ratio gallery
Combining 1:1, 4:3 and 16:9 tiles in one responsive grid.
<div class="row g-2">
<div class="col-md-6">
<div class="ratio ratio-4x3 rounded overflow-hidden">
<img src="https://images.unsplash.com/photo-1758691461990-03b49d969495?auto=format&fit=crop&w=1200&h=800&q=70" alt="Gallery photo 1" class="object-fit-cover">
</div>
</div>
<div class="col-md-6">
<div class="row g-2">
<div class="col-6">
<div class="ratio ratio-1x1 rounded overflow-hidden">
<img src="https://images.unsplash.com/photo-1758691462858-f1286e5daf40?auto=format&fit=crop&w=800&h=800&q=70" alt="Gallery photo 2" class="object-fit-cover">
</div>
</div>
<div class="col-6">
<div class="ratio ratio-1x1 rounded overflow-hidden">
<img src="https://images.unsplash.com/photo-1631217871099-88310a909a32?auto=format&fit=crop&w=800&h=800&q=70" alt="Gallery photo 3" class="object-fit-cover">
</div>
</div>
<div class="col-12">
<div class="ratio ratio-21x9 rounded overflow-hidden">
<img src="https://images.unsplash.com/photo-1758691462126-2ee47c8bf9e7?auto=format&fit=crop&w=1600&h=700&q=70" alt="Gallery photo 4" class="object-fit-cover">
</div>
</div>
</div>
</div>
</div>13Thumbnails in table cells
A small ratio-1x1 box keeps order line images square inside a table.
| Image | Item | Price |
|---|---|---|
| Child check-up | $72.00 | |
| Blood test | $44.00 | |
| Dental cleaning | $98.00 |
<table class="table align-middle mb-0">
<thead>
<tr>
<th scope="col"><span class="visually-hidden">Image</span></th>
<th scope="col">Item</th>
<th scope="col" class="text-end">Price</th>
</tr>
</thead>
<tbody>
<tr>
<td style="width:4rem"><div class="ratio ratio-1x1 rounded overflow-hidden"><img src="../assets/img/product-9.svg" alt="Child check-up" class="object-fit-cover"></div></td>
<td class="align-middle">Child check-up</td>
<td class="align-middle text-end">$72.00</td>
</tr>
<tr>
<td style="width:4rem"><div class="ratio ratio-1x1 rounded overflow-hidden"><img src="../assets/img/product-4.svg" alt="Blood test" class="object-fit-cover"></div></td>
<td class="align-middle">Blood test</td>
<td class="align-middle text-end">$44.00</td>
</tr>
<tr>
<td style="width:4rem"><div class="ratio ratio-1x1 rounded overflow-hidden"><img src="../assets/img/product-2.svg" alt="Dental cleaning" class="object-fit-cover"></div></td>
<td class="align-middle">Dental cleaning</td>
<td class="align-middle text-end">$98.00</td>
</tr>
</tbody>
</table>14Empty cover placeholder
A dashed 4:3 area that reserves space for an image that has not been chosen yet.
<div class="ratio ratio-4x3" style="max-width:20rem">
<div class="d-flex flex-column align-items-center justify-content-center border border-2 border-secondary-subtle rounded-3 text-body-secondary wt-border-dashed">
<span class="fs-2"><i class="bi bi-image" aria-hidden="true"></i></span><span class="small">No cover image yet</span>
</div>
</div>15Colour swatches
Empty square ratios make perfect colour swatches for a style guide.
primary
secondary
success
info
warning
danger
<div class="row g-2">
<div class="col-4 col-md-2">
<div class="ratio ratio-1x1 rounded-3 bg-primary">
<span class="visually-hidden">primary</span>
</div>
<p class="small text-center mt-1 mb-0">primary</p>
</div>
<div class="col-4 col-md-2">
<div class="ratio ratio-1x1 rounded-3 bg-secondary">
<span class="visually-hidden">secondary</span>
</div>
<p class="small text-center mt-1 mb-0">secondary</p>
</div>
<div class="col-4 col-md-2">
<div class="ratio ratio-1x1 rounded-3 bg-success">
<span class="visually-hidden">success</span>
</div>
<p class="small text-center mt-1 mb-0">success</p>
</div>
<div class="col-4 col-md-2">
<div class="ratio ratio-1x1 rounded-3 bg-info">
<span class="visually-hidden">info</span>
</div>
<p class="small text-center mt-1 mb-0">info</p>
</div>
<div class="col-4 col-md-2">
<div class="ratio ratio-1x1 rounded-3 bg-warning">
<span class="visually-hidden">warning</span>
</div>
<p class="small text-center mt-1 mb-0">warning</p>
</div>
<div class="col-4 col-md-2">
<div class="ratio ratio-1x1 rounded-3 bg-danger">
<span class="visually-hidden">danger</span>
</div>
<p class="small text-center mt-1 mb-0">danger</p>
</div>
</div>16Video thumbnails with badges
Duration and status badges positioned over 16:9 thumbnails.
What to expect at your first dental visit
Looking back at a busy season
Understanding your blood test results
<div class="row g-3">
<div class="col-md-4">
<div class="ratio ratio-16x9 rounded overflow-hidden">
<div>
<img src="https://images.unsplash.com/photo-1584516150909-c43483ee7932?auto=format&fit=crop&w=1200&h=800&q=70" alt="" class="w-100 h-100 object-fit-cover"><span class="position-absolute bottom-0 end-0 m-2 badge text-bg-dark">13:56</span><span class="position-absolute top-0 start-0 m-2 badge text-bg-danger">New</span>
</div>
</div>
<p class="small fw-semibold mt-1 mb-0">What to expect at your first dental visit</p>
</div>
<div class="col-md-4">
<div class="ratio ratio-16x9 rounded overflow-hidden">
<div>
<img src="https://images.unsplash.com/photo-1606318313647-137d1f3b4d3c?auto=format&fit=crop&w=1200&h=800&q=70" alt="" class="w-100 h-100 object-fit-cover"><span class="position-absolute bottom-0 end-0 m-2 badge text-bg-dark">11:46</span>
</div>
</div>
<p class="small fw-semibold mt-1 mb-0">Looking back at a busy season</p>
</div>
<div class="col-md-4">
<div class="ratio ratio-16x9 rounded overflow-hidden">
<div>
<img src="https://images.unsplash.com/photo-1758691462878-6edc3d3da1be?auto=format&fit=crop&w=1200&h=800&q=70" alt="" class="w-100 h-100 object-fit-cover"><span class="position-absolute bottom-0 end-0 m-2 badge text-bg-dark">8:11</span>
</div>
</div>
<p class="small fw-semibold mt-1 mb-0">Understanding your blood test results</p>
</div>
</div>17Media list
Fixed width 4:3 thumbnails beside article titles in a reading list.
What our patients asked us most
May 28, 2026 · 3 min read
A parent's guide to childhood vaccinations
Sep 26, 2025 · 12 min read
How often should you have a health check-up?
Apr 2, 2026 · 11 min read
<ul class="list-unstyled mb-0 vstack gap-3">
<li class="d-flex gap-3"><div class="flex-shrink-0" style="width:6rem"><div class="ratio ratio-4x3 rounded overflow-hidden"><img src="https://images.unsplash.com/photo-1631217873436-b0fa88e71f0a?auto=format&fit=crop&w=1200&h=800&q=70" alt="" class="object-fit-cover"></div></div><div><h3 class="h6 mb-1">What our patients asked us most</h3><p class="small text-body-secondary mb-0">May 28, 2026 · 3 min read</p></div></li>
<li class="d-flex gap-3"><div class="flex-shrink-0" style="width:6rem"><div class="ratio ratio-4x3 rounded overflow-hidden"><img src="https://images.unsplash.com/photo-1758691462126-2ee47c8bf9e7?auto=format&fit=crop&w=1200&h=800&q=70" alt="" class="object-fit-cover"></div></div><div><h3 class="h6 mb-1">A parent's guide to childhood vaccinations</h3><p class="small text-body-secondary mb-0">Sep 26, 2025 · 12 min read</p></div></li>
<li class="d-flex gap-3"><div class="flex-shrink-0" style="width:6rem"><div class="ratio ratio-4x3 rounded overflow-hidden"><img src="https://images.unsplash.com/photo-1758691462858-f1286e5daf40?auto=format&fit=crop&w=1200&h=800&q=70" alt="" class="object-fit-cover"></div></div><div><h3 class="h6 mb-1">How often should you have a health check-up?</h3><p class="small text-body-secondary mb-0">Apr 2, 2026 · 11 min read</p></div></li>
</ul>18Responsive ratio
A small custom class changes --bs-aspect-ratio per breakpoint: square on phones, 21:9 on tablets and up.
<div class="ratio hp-ratio-resp rounded-3 overflow-hidden">
<img src="https://images.unsplash.com/photo-1631217871099-88310a909a32?auto=format&fit=crop&w=1600&h=700&q=70" alt="Get answers, get better" class="object-fit-cover">
</div>19Round avatars
ratio-1x1 with rounded-circle keeps profile pictures perfectly round even when the source is not square.
<div class="d-flex flex-wrap gap-3">
<div class="text-center" style="width:5rem">
<div class="ratio ratio-1x1 rounded-circle overflow-hidden border border-2 border-primary">
<img src="../assets/img/avatar-4.svg" alt="Finn Duarte" class="object-fit-cover">
</div>
<span class="small d-block text-truncate mt-1">Finn</span>
</div>
<div class="text-center" style="width:5rem">
<div class="ratio ratio-1x1 rounded-circle overflow-hidden border border-2 border-primary">
<img src="../assets/img/avatar-7.svg" alt="Ella Patel" class="object-fit-cover">
</div>
<span class="small d-block text-truncate mt-1">Ella</span>
</div>
<div class="text-center" style="width:5rem">
<div class="ratio ratio-1x1 rounded-circle overflow-hidden border border-2 border-primary">
<img src="../assets/img/avatar-5.svg" alt="Lea Rossi" class="object-fit-cover">
</div>
<span class="small d-block text-truncate mt-1">Lea</span>
</div>
<div class="text-center" style="width:5rem">
<div class="ratio ratio-1x1 rounded-circle overflow-hidden border border-2 border-primary">
<img src="../assets/img/avatar-8.svg" alt="Elena Larsen" class="object-fit-cover">
</div>
<span class="small d-block text-truncate mt-1">Elena</span>
</div>
</div>20Loading skeleton
A 16:9 placeholder block with placeholder-glow while the real image and text load.
The skeleton reserves the exact space, so the page does not jump when content arrives.
<div class="card" style="max-width:22rem" aria-hidden="true">
<div class="ratio ratio-16x9 placeholder-glow">
<span class="placeholder"></span>
</div>
<div class="card-body placeholder-glow">
<span class="placeholder col-7 mb-2"></span><span class="placeholder col-4"></span>
</div>
</div>
<p class="small text-body-secondary mt-2 mb-0">The skeleton reserves the exact space, so the page does not jump when content arrives.</p>