Bootstrap Profile: 16 Examples of Pages, Cards and Settings

Themewagon's free Profile template still lists Bootstrap 4 and jQuery as its stack, and Bootstrap 4 reached end of life on January 1, 2023. Plenty of profile snippets were written against it, so check the Bootstrap version before anything else.

Below are 16 Bootstrap profile examples you can copy, followed by a guide to the components, grid, accessibility and templates behind them.

By Bogdan Sandu ยท Updated October 29, 2026

Every example runs on Bootstrap 5.3.8 from the jsDelivr CDN. Add these tags to your page, then paste an example's HTML, CSS and JS.

<link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.8/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-sRIl4kxILFvY47J16cr9ZwB07vP4J8+LH7qKQnuqkuIAvNWLzeN8tE5YBujZqJLB" crossorigin="anonymous">
<link href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.13.2/font/bootstrap-icons.min.css" rel="stylesheet" integrity="sha384-nWN3KqaaVcbEsCjLSV+2jMjh62Iny/+mN3srM8TZeM8N6aj7eDl5wwYggjAJ4/sJ" crossorigin="anonymous">
<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.8/dist/js/bootstrap.bundle.min.js" integrity="sha384-FKyoEForCGlyvwx9Hj09JcYn3nv7wiPVlz7YYwJrWVcXK/BmnVDxM+D2scQbITxI" crossorigin="anonymous"></script>

Profile pages and layouts

Full profile layouts: a social header with a cover and an overlapping avatar, a sidebar and details split on the grid, a tabbed profile and a marketplace seller page with ratings and reviews.

Social profile header with cover and follow toggle

  • object-fit-cover
  • flex-md-row
  • aria-pressed
  • --bs-btn-*

Click Follow.

A full-width cover photo, an initials avatar pulled up over it with a negative margin and a ring in the body color, and a header that stacks on phones and lines up in a row from md. The Follow button is a real toggle: the script flips aria-pressed, swaps the label and icon and updates the follower count, and the pressed look comes from --bs-btn-* variables scoped to the button.

View code
<div class="bpf-social">
  <img src="fjord.webp" class="bpf-social-cover w-100 object-fit-cover" alt="" width="800" height="600">
  <div class="px-3 px-md-4 pb-4">
    <div class="d-flex flex-column flex-md-row align-items-center align-items-md-end gap-3">
      <span class="bpf-social-av rounded-circle d-inline-flex align-items-center justify-content-center fw-semibold flex-shrink-0" aria-hidden="true">IV</span>
      <div class="text-center text-md-start flex-grow-1">
        <h2 class="h4 mb-0">Ines Varga</h2>
        <p class="text-body-secondary mb-0">Product designer at Northwind Studio, Lisbon</p>
      </div>
      <div class="d-flex gap-2">
        <button type="button" class="btn bpf-follow px-4" id="bpf-follow" aria-pressed="false"><i class="bi bi-person-plus me-1" aria-hidden="true" id="bpf-follow-icon"></i><span id="bpf-follow-label">Follow</span></button>
        <a href="#" class="btn btn-outline-secondary bpf-square" aria-label="Message Ines"><i class="bi bi-envelope" aria-hidden="true"></i></a>
        <a href="#" class="btn btn-outline-secondary bpf-square" aria-label="Copy profile link"><i class="bi bi-link-45deg" aria-hidden="true"></i></a>
      </div>
    </div>
    <p class="mt-3 mb-3 text-center text-md-start bpf-social-bio">Design systems, type, and weekend sailing. Currently rebuilding a ferry booking app one component at a time.</p>
    <ul class="list-unstyled row row-cols-3 g-0 text-center border rounded-3 py-2 mb-0 bpf-social-stats">
      <li class="col"><span class="d-block fw-bold fs-5">312</span><span class="small text-body-secondary">Shots</span></li>
      <li class="col border-start"><span class="d-block fw-bold fs-5" id="bpf-followers">2,481</span><span class="small text-body-secondary">Followers</span></li>
      <li class="col border-start"><span class="d-block fw-bold fs-5">190</span><span class="small text-body-secondary">Following</span></li>
    </ul>
    <p class="visually-hidden" role="status" id="bpf-follow-status"></p>
  </div>
</div>

Profile with Posts, About and Activity tabs

  • nav-tabs
  • card-header-tabs
  • data-bs-toggle="tab"
  • role="tablist"

Switch tabs, or focus a tab and use the arrow keys.

The tab plugin on card-header-tabs: buttons with data-bs-toggle="tab", data-bs-target and aria-controls, panes with tab-pane fade. Because the tabs switch panes on the same page, the roles tablist, tab and tabpanel are correct here, and Bootstrap keeps aria-selected and the arrow-key navigation in sync. No custom JS.

View code
<div class="card bpf-tabs w-100 shadow-sm">
  <div class="card-body d-flex align-items-center gap-3 pb-3">
    <span class="bpf-tabs-av rounded-circle d-inline-flex align-items-center justify-content-center fw-semibold flex-shrink-0" aria-hidden="true">ML</span>
    <div>
      <h2 class="h5 mb-0">Malik Lowe</h2>
      <p class="small text-body-secondary mb-0">@maliklowe &middot; Food writer, Bristol</p>
    </div>
  </div>
  <div class="card-header bg-transparent">
    <ul class="nav nav-tabs card-header-tabs" role="tablist">
      <li class="nav-item" role="presentation"><button class="nav-link active" id="bpf-tab-posts" data-bs-toggle="tab" data-bs-target="#bpf-pane-posts" type="button" role="tab" aria-controls="bpf-pane-posts" aria-selected="true">Posts</button></li>
      <li class="nav-item" role="presentation"><button class="nav-link" id="bpf-tab-about" data-bs-toggle="tab" data-bs-target="#bpf-pane-about" type="button" role="tab" aria-controls="bpf-pane-about" aria-selected="false">About</button></li>
      <li class="nav-item" role="presentation"><button class="nav-link" id="bpf-tab-activity" data-bs-toggle="tab" data-bs-target="#bpf-pane-activity" type="button" role="tab" aria-controls="bpf-pane-activity" aria-selected="false">Activity</button></li>
    </ul>
  </div>
  <div class="card-body tab-content">
    <div class="tab-pane fade show active" id="bpf-pane-posts" role="tabpanel" aria-labelledby="bpf-tab-posts" tabindex="0">
      <article class="pb-3 mb-3 border-bottom">
        <h3 class="h6 mb-1">The two-day sourdough schedule that fits a work week</h3>
        <p class="small text-body-secondary mb-1">Mix on Tuesday night, bake on Thursday morning, eat warm bread before nine.</p>
        <p class="small text-body-secondary mb-0"><i class="bi bi-heart me-1" aria-hidden="true"></i>214 likes &middot; 3 days ago</p>
      </article>
      <article>
        <h3 class="h6 mb-1">Every bakery on Gloucester Road, ranked by croissant</h3>
        <p class="small text-body-secondary mb-1">Eleven shops, one Saturday, a very full notebook.</p>
        <p class="small text-body-secondary mb-0"><i class="bi bi-heart me-1" aria-hidden="true"></i>1,032 likes &middot; 2 weeks ago</p>
      </article>
    </div>
    <div class="tab-pane fade" id="bpf-pane-about" role="tabpanel" aria-labelledby="bpf-tab-about" tabindex="0">
      <p>Writes the weekly Crumb column and a newsletter about bread for people with full-time jobs.</p>
      <dl class="row small mb-0">
        <dt class="col-sm-4 text-body-secondary fw-normal">Joined</dt><dd class="col-sm-8">March 2021</dd>
        <dt class="col-sm-4 text-body-secondary fw-normal">Location</dt><dd class="col-sm-8">Bristol, UK</dd>
        <dt class="col-sm-4 text-body-secondary fw-normal">Website</dt><dd class="col-sm-8 mb-0"><a href="#">crumbweekly.example</a></dd>
      </dl>
    </div>
    <div class="tab-pane fade" id="bpf-pane-activity" role="tabpanel" aria-labelledby="bpf-tab-activity" tabindex="0">
      <ul class="list-group list-group-flush small">
        <li class="list-group-item px-0 d-flex justify-content-between gap-3"><span><i class="bi bi-chat-left-text me-2 text-body-secondary" aria-hidden="true"></i>Replied to a thread on rye starters</span><span class="text-body-secondary text-nowrap">2 h</span></li>
        <li class="list-group-item px-0 d-flex justify-content-between gap-3"><span><i class="bi bi-bookmark me-2 text-body-secondary" aria-hidden="true"></i>Saved Focaccia for beginners</span><span class="text-body-secondary text-nowrap">Yesterday</span></li>
        <li class="list-group-item px-0 d-flex justify-content-between gap-3"><span><i class="bi bi-person-plus me-2 text-body-secondary" aria-hidden="true"></i>Started following Ada Brennan</span><span class="text-body-secondary text-nowrap">Mon</span></li>
      </ul>
    </div>
  </div>
</div>

Marketplace seller profile with rating and reviews

  • bi-star-fill
  • progress
  • visually-hidden
  • collapse

Click Show 2 more reviews.

Stars come from Bootstrap Icons and are aria-hidden, with the rating repeated as visually-hidden text so screen readers hear "4.8 out of 5". The breakdown uses thin progress bars with the percentage printed beside each one, and the older reviews sit in a collapse wired with aria-expanded and aria-controls.

View code
<div class="card bpf-seller w-100 shadow-sm">
  <div class="card-body p-4">
    <div class="d-flex flex-wrap align-items-center gap-3 mb-4">
      <span class="bpf-seller-av rounded-3 d-inline-flex align-items-center justify-content-center fw-bold flex-shrink-0" aria-hidden="true">JP</span>
      <div class="flex-grow-1">
        <h2 class="h5 mb-0">Juniper Print Co.</h2>
        <p class="small text-body-secondary mb-0">Hana Mori &middot; Risograph prints, Osaka &middot; Selling since 2019</p>
      </div>
      <a href="#" class="btn btn-dark px-4 py-2">Contact seller</a>
    </div>
    <div class="row g-4 align-items-center mb-2">
      <div class="col-sm-4 text-center">
        <p class="display-5 fw-bold mb-0">4.8</p>
        <p class="bpf-stars mb-1" aria-hidden="true"><i class="bi bi-star-fill"></i><i class="bi bi-star-fill"></i><i class="bi bi-star-fill"></i><i class="bi bi-star-fill"></i><i class="bi bi-star-half"></i></p>
        <p class="visually-hidden">Rated 4.8 out of 5</p>
        <p class="small text-body-secondary mb-0">1,284 reviews</p>
      </div>
      <div class="col-sm-8">
        <div class="d-flex align-items-center gap-2 small mb-1"><span class="bpf-seller-n">5 stars</span><div class="progress flex-grow-1" role="progressbar" aria-label="5 star reviews" aria-valuenow="84" aria-valuemin="0" aria-valuemax="100"><div class="progress-bar" style="width: 84%"></div></div><span class="bpf-seller-p text-body-secondary">84%</span></div>
        <div class="d-flex align-items-center gap-2 small mb-1"><span class="bpf-seller-n">4 stars</span><div class="progress flex-grow-1" role="progressbar" aria-label="4 star reviews" aria-valuenow="11" aria-valuemin="0" aria-valuemax="100"><div class="progress-bar" style="width: 11%"></div></div><span class="bpf-seller-p text-body-secondary">11%</span></div>
        <div class="d-flex align-items-center gap-2 small mb-1"><span class="bpf-seller-n">3 stars</span><div class="progress flex-grow-1" role="progressbar" aria-label="3 star reviews" aria-valuenow="3" aria-valuemin="0" aria-valuemax="100"><div class="progress-bar" style="width: 3%"></div></div><span class="bpf-seller-p text-body-secondary">3%</span></div>
        <div class="d-flex align-items-center gap-2 small mb-1"><span class="bpf-seller-n">2 stars</span><div class="progress flex-grow-1" role="progressbar" aria-label="2 star reviews" aria-valuenow="1" aria-valuemin="0" aria-valuemax="100"><div class="progress-bar" style="width: 1%"></div></div><span class="bpf-seller-p text-body-secondary">1%</span></div>
        <div class="d-flex align-items-center gap-2 small"><span class="bpf-seller-n">1 star</span><div class="progress flex-grow-1" role="progressbar" aria-label="1 star reviews" aria-valuenow="1" aria-valuemin="0" aria-valuemax="100"><div class="progress-bar" style="width: 1%"></div></div><span class="bpf-seller-p text-body-secondary">1%</span></div>
      </div>
    </div>
  </div>
  <ul class="list-group list-group-flush">
    <li class="list-group-item px-4 py-3">
      <div class="d-flex justify-content-between gap-2 mb-1"><strong class="small">Petra K.</strong><span class="small text-body-secondary">Oct 12, 2026</span></div>
      <p class="bpf-stars small mb-1" aria-hidden="true"><i class="bi bi-star-fill"></i><i class="bi bi-star-fill"></i><i class="bi bi-star-fill"></i><i class="bi bi-star-fill"></i><i class="bi bi-star-fill"></i></p>
      <p class="visually-hidden">5 out of 5</p>
      <p class="small mb-0">The ink colors are even better in person. Packed flat between two boards, not a single bent corner.</p>
    </li>
    <li class="list-group-item px-4 py-3">
      <div class="d-flex justify-content-between gap-2 mb-1"><strong class="small">Daniel O.</strong><span class="small text-body-secondary">Sep 30, 2026</span></div>
      <p class="bpf-stars small mb-1" aria-hidden="true"><i class="bi bi-star-fill"></i><i class="bi bi-star-fill"></i><i class="bi bi-star-fill"></i><i class="bi bi-star-fill"></i><i class="bi bi-star"></i></p>
      <p class="visually-hidden">4 out of 5</p>
      <p class="small mb-0">Lovely print, shipping to Canada took twelve days.</p>
    </li>
  </ul>
  <div class="collapse" id="bpf-more-reviews">
    <ul class="list-group list-group-flush border-top">
      <li class="list-group-item px-4 py-3">
        <div class="d-flex justify-content-between gap-2 mb-1"><strong class="small">Amaru T.</strong><span class="small text-body-secondary">Sep 21, 2026</span></div>
        <p class="bpf-stars small mb-1" aria-hidden="true"><i class="bi bi-star-fill"></i><i class="bi bi-star-fill"></i><i class="bi bi-star-fill"></i><i class="bi bi-star-fill"></i><i class="bi bi-star-fill"></i></p>
        <p class="visually-hidden">5 out of 5</p>
        <p class="small mb-0">Third order. Hana added a small sticker sheet, which my kid stole immediately.</p>
      </li>
      <li class="list-group-item px-4 py-3">
        <div class="d-flex justify-content-between gap-2 mb-1"><strong class="small">Ruth V.</strong><span class="small text-body-secondary">Sep 2, 2026</span></div>
        <p class="bpf-stars small mb-1" aria-hidden="true"><i class="bi bi-star-fill"></i><i class="bi bi-star-fill"></i><i class="bi bi-star-fill"></i><i class="bi bi-star-fill"></i><i class="bi bi-star-fill"></i></p>
        <p class="visually-hidden">5 out of 5</p>
        <p class="small mb-0">Framed it the day it arrived.</p>
      </li>
    </ul>
  </div>
  <div class="card-footer bg-transparent text-center">
    <button class="btn btn-link link-body-emphasis bpf-more-btn" type="button" data-bs-toggle="collapse" data-bs-target="#bpf-more-reviews" aria-expanded="false" aria-controls="bpf-more-reviews" id="bpf-more-toggle">Show 2 more reviews</button>
  </div>
</div>

Team grids, directories and contact cards

Profiles in bulk: a team grid with social links, a member directory you can search, a vCard-style contact card and an avatar stack with tooltips and an overflow menu.

Team member grid with roles and social links

  • row-cols-sm-2 row-cols-md-4
  • h-100
  • rounded-circle
  • aria-label

One col per person in a row with row-cols-1 row-cols-sm-2 row-cols-md-4 g-3, and h-100 so the cards match in height. Avatars are initials on colored circles built from flex utilities, the role is a subtle badge, and every icon-only link carries an aria-label with the person and the destination.

View code
<div class="bpf-team w-100">
  <div class="row row-cols-1 row-cols-sm-2 row-cols-md-4 g-3">
    <div class="col">
      <div class="card h-100 text-center border-0 shadow-sm">
        <div class="card-body p-4">
          <span class="bpf-team-av rounded-circle d-inline-flex align-items-center justify-content-center fw-semibold mb-3" style="--bpf-av: #1e40af" aria-hidden="true">AR</span>
          <h3 class="h6 mb-1">Ana Ruiz</h3>
          <span class="badge bg-primary-subtle text-primary-emphasis mb-3">Founder</span>
          <p class="small text-body-secondary">Ran a print shop for ten years before starting the studio.</p>
          <div class="d-flex justify-content-center gap-1">
            <a href="#" class="btn btn-light bpf-team-link" aria-label="Email Ana Ruiz"><i class="bi bi-envelope" aria-hidden="true"></i></a>
            <a href="#" class="btn btn-light bpf-team-link" aria-label="Ana Ruiz website"><i class="bi bi-globe" aria-hidden="true"></i></a>
            <a href="#" class="btn btn-light bpf-team-link" aria-label="Ana Ruiz portfolio"><i class="bi bi-link-45deg" aria-hidden="true"></i></a>
          </div>
        </div>
      </div>
    </div>
    <div class="col">
      <div class="card h-100 text-center border-0 shadow-sm">
        <div class="card-body p-4">
          <span class="bpf-team-av rounded-circle d-inline-flex align-items-center justify-content-center fw-semibold mb-3" style="--bpf-av: #0f766e" aria-hidden="true">JN</span>
          <h3 class="h6 mb-1">Jonah Novak</h3>
          <span class="badge bg-success-subtle text-success-emphasis mb-3">Lead developer</span>
          <p class="small text-body-secondary">Ships the front end and owns the component library.</p>
          <div class="d-flex justify-content-center gap-1">
            <a href="#" class="btn btn-light bpf-team-link" aria-label="Email Jonah Novak"><i class="bi bi-envelope" aria-hidden="true"></i></a>
            <a href="#" class="btn btn-light bpf-team-link" aria-label="Jonah Novak website"><i class="bi bi-globe" aria-hidden="true"></i></a>
            <a href="#" class="btn btn-light bpf-team-link" aria-label="Jonah Novak portfolio"><i class="bi bi-link-45deg" aria-hidden="true"></i></a>
          </div>
        </div>
      </div>
    </div>
    <div class="col">
      <div class="card h-100 text-center border-0 shadow-sm">
        <div class="card-body p-4">
          <span class="bpf-team-av rounded-circle d-inline-flex align-items-center justify-content-center fw-semibold mb-3" style="--bpf-av: #9d174d" aria-hidden="true">SK</span>
          <h3 class="h6 mb-1">Sofia Kim</h3>
          <span class="badge bg-danger-subtle text-danger-emphasis mb-3">Brand designer</span>
          <p class="small text-body-secondary">Logos, type and the occasional mural.</p>
          <div class="d-flex justify-content-center gap-1">
            <a href="#" class="btn btn-light bpf-team-link" aria-label="Email Sofia Kim"><i class="bi bi-envelope" aria-hidden="true"></i></a>
            <a href="#" class="btn btn-light bpf-team-link" aria-label="Sofia Kim website"><i class="bi bi-globe" aria-hidden="true"></i></a>
            <a href="#" class="btn btn-light bpf-team-link" aria-label="Sofia Kim portfolio"><i class="bi bi-link-45deg" aria-hidden="true"></i></a>
          </div>
        </div>
      </div>
    </div>
    <div class="col">
      <div class="card h-100 text-center border-0 shadow-sm">
        <div class="card-body p-4">
          <span class="bpf-team-av rounded-circle d-inline-flex align-items-center justify-content-center fw-semibold mb-3" style="--bpf-av: #5b21b6" aria-hidden="true">EB</span>
          <h3 class="h6 mb-1">Emeka Bello</h3>
          <span class="badge bg-secondary-subtle text-secondary-emphasis mb-3">Producer</span>
          <p class="small text-body-secondary">Keeps budgets, timelines and clients happy at once.</p>
          <div class="d-flex justify-content-center gap-1">
            <a href="#" class="btn btn-light bpf-team-link" aria-label="Email Emeka Bello"><i class="bi bi-envelope" aria-hidden="true"></i></a>
            <a href="#" class="btn btn-light bpf-team-link" aria-label="Emeka Bello website"><i class="bi bi-globe" aria-hidden="true"></i></a>
            <a href="#" class="btn btn-light bpf-team-link" aria-label="Emeka Bello portfolio"><i class="bi bi-link-45deg" aria-hidden="true"></i></a>
          </div>
        </div>
      </div>
    </div>
  </div>
</div>

Contact card with expandable details

  • list-group-flush
  • collapse
  • aria-expanded
  • text-break

Click More details.

A vCard-style contact card: identity block, a flush list group of contact rows with icons, and the lower-priority details in a collapse toggled by a button with aria-expanded and aria-controls. text-break stops the long email address from pushing the card wider on phones.

View code
<div class="card bpf-vcard w-100 shadow-sm">
  <div class="card-body d-flex gap-3 align-items-center">
    <svg class="flex-shrink-0" viewBox="0 0 72 72" width="72" height="72" aria-hidden="true">
      <rect width="72" height="72" rx="36" fill="#0f766e"/>
      <rect x="10" y="40" width="52" height="40" rx="20" fill="#5eead4"/>
      <circle cx="36" cy="30" r="13" fill="#ccfbf1"/>
    </svg>
    <div>
      <h2 class="h5 mb-0">Lucia Ferrante</h2>
      <p class="mb-0">Partnerships manager</p>
      <p class="small text-body-secondary mb-0">Tidewater Logistics</p>
    </div>
  </div>
  <ul class="list-group list-group-flush">
    <li class="list-group-item d-flex gap-3"><i class="bi bi-envelope text-body-secondary" aria-hidden="true"></i><a href="#" class="text-break link-body-emphasis">lucia.ferrante@tidewater.example</a></li>
    <li class="list-group-item d-flex gap-3"><i class="bi bi-telephone text-body-secondary" aria-hidden="true"></i><a href="#" class="link-body-emphasis">+39 02 5551 0187</a></li>
    <li class="list-group-item d-flex gap-3"><i class="bi bi-globe text-body-secondary" aria-hidden="true"></i><a href="#" class="link-body-emphasis">tidewater.example</a></li>
    <li class="list-group-item d-flex gap-3"><i class="bi bi-geo-alt text-body-secondary" aria-hidden="true"></i><span>Via Lecco 14, Milan</span></li>
  </ul>
  <div class="collapse" id="bpf-vcard-more">
    <dl class="row small mx-0 px-3 pt-3 mb-0 border-top">
      <dt class="col-5 fw-normal text-body-secondary">Time zone</dt><dd class="col-7">CET, UTC+1</dd>
      <dt class="col-5 fw-normal text-body-secondary">Languages</dt><dd class="col-7">Italian, English, Spanish</dd>
      <dt class="col-5 fw-normal text-body-secondary">Best time</dt><dd class="col-7">Tue to Thu, 10:00 to 13:00</dd>
    </dl>
  </div>
  <div class="card-footer bg-transparent d-flex gap-2">
    <a href="#" class="btn btn-success flex-grow-1 py-2"><i class="bi bi-person-vcard me-2" aria-hidden="true"></i>Save contact</a>
    <button class="btn btn-outline-secondary py-2" type="button" data-bs-toggle="collapse" data-bs-target="#bpf-vcard-more" aria-expanded="false" aria-controls="bpf-vcard-more" id="bpf-vcard-toggle">More details</button>
  </div>
</div>

Avatar stack with tooltips and an overflow menu

  • bootstrap.Tooltip
  • dropdown
  • visually-hidden
  • z-index

Hover or focus an avatar, then open +3.

Overlapping avatars, each a focusable link with the full name in visually-hidden text and a tooltip from the Tooltip plugin, so the name shows on hover and on keyboard focus. The +3 button is a regular dropdown listing the rest of the team. The overlap and the ring are a few lines of CSS on the prefixed class.

View code
<div class="card bpf-stack-card w-100 shadow-sm">
  <div class="card-body p-4">
    <div class="d-flex justify-content-between align-items-start gap-2 mb-1">
      <h2 class="h6 mb-0">Harbor app redesign</h2>
      <span class="badge text-bg-warning">Due Nov 18</span>
    </div>
    <p class="small text-body-secondary mb-3">Booking flow, seat maps and the new loyalty screen.</p>
    <div class="progress mb-1" role="progressbar" aria-label="Project progress" aria-valuenow="65" aria-valuemin="0" aria-valuemax="100" style="height: .5rem"><div class="progress-bar bg-dark" style="width: 65%"></div></div>
    <p class="small text-body-secondary mb-4">65% done, 9 of 14 tasks</p>
    <div class="d-flex align-items-center">
      <div class="bpf-stack d-flex">
        <a href="#" class="bpf-stack-av" style="--bpf-av: #1e40af" data-bs-toggle="tooltip" data-bs-title="Lena Fischer, design lead"><span aria-hidden="true">LF</span><span class="visually-hidden">Lena Fischer, design lead</span></a>
        <a href="#" class="bpf-stack-av" style="--bpf-av: #be123c" data-bs-toggle="tooltip" data-bs-title="Omar Haddad, iOS"><span aria-hidden="true">OH</span><span class="visually-hidden">Omar Haddad, iOS</span></a>
        <a href="#" class="bpf-stack-av" style="--bpf-av: #166534" data-bs-toggle="tooltip" data-bs-title="Priya Nair, Android"><span aria-hidden="true">PN</span><span class="visually-hidden">Priya Nair, Android</span></a>
        <a href="#" class="bpf-stack-av" style="--bpf-av: #5b21b6" data-bs-toggle="tooltip" data-bs-title="Will Osei, QA"><span aria-hidden="true">WO</span><span class="visually-hidden">Will Osei, QA</span></a>
        <div class="dropdown">
          <button class="bpf-stack-av bpf-stack-more" type="button" id="bpf-stack-more" data-bs-toggle="dropdown" aria-expanded="false"><span aria-hidden="true">+3</span><span class="visually-hidden">Show 3 more team members</span></button>
          <ul class="dropdown-menu shadow-sm" aria-labelledby="bpf-stack-more">
            <li><a class="dropdown-item d-flex align-items-center gap-2" href="#"><span class="bpf-stack-mini" style="--bpf-av: #0f766e" aria-hidden="true">RT</span>Rosa Tan, copywriter</a></li>
            <li><a class="dropdown-item d-flex align-items-center gap-2" href="#"><span class="bpf-stack-mini" style="--bpf-av: #92400e" aria-hidden="true">KB</span>Karl Berg, backend</a></li>
            <li><a class="dropdown-item d-flex align-items-center gap-2" href="#"><span class="bpf-stack-mini" style="--bpf-av: #334155" aria-hidden="true">YA</span>Yara Aziz, product</a></li>
          </ul>
        </div>
      </div>
      <a href="#" class="btn btn-sm btn-outline-dark ms-auto py-2 px-3"><i class="bi bi-person-plus me-1" aria-hidden="true"></i>Invite</a>
    </div>
  </div>
</div>

Account menus, settings and editing

The signed-in side of a profile: the navbar avatar menu, an account settings form with a photo preview, an edit modal that writes back to the card and a completeness checklist.

Account settings form with avatar upload preview

  • form-control
  • was-validated
  • URL.createObjectURL
  • input-group

Choose a photo, edit the fields and click Save changes.

Bootstrap form controls with the validation pattern: novalidate, checkValidity() and .was-validated, plus invalid-feedback text for each rule. Choosing a photo creates an img in the avatar from URL.createObjectURL, and the object URL is revoked as soon as the image has loaded (or fails to). Files over 2 MB get a custom validity message. Nothing is uploaded; saving the file is server work.

View code
<form class="card bpf-set w-100 shadow-sm" id="bpf-set-form" novalidate>
  <div class="card-header bg-transparent py-3"><h2 class="h6 mb-0">Profile settings</h2></div>
  <div class="card-body p-4">
    <div class="d-flex flex-wrap align-items-center gap-3 mb-4">
      <span class="bpf-set-av rounded-circle flex-shrink-0" id="bpf-set-avatar"><span aria-hidden="true" id="bpf-set-initials">NE</span></span>
      <div class="flex-grow-1 bpf-set-file">
        <label for="bpf-set-photo" class="form-label fw-semibold mb-1">Profile photo</label>
        <input class="form-control" type="file" id="bpf-set-photo" accept="image/png, image/jpeg, image/webp" aria-describedby="bpf-set-photo-help">
        <div class="form-text" id="bpf-set-photo-help">PNG, JPG or WebP, up to 2 MB.</div>
        <div class="invalid-feedback">That file is larger than 2 MB.</div>
      </div>
    </div>
    <div class="row g-3">
      <div class="col-sm-6">
        <label for="bpf-set-name" class="form-label">Display name</label>
        <input type="text" class="form-control" id="bpf-set-name" value="Nadia Ellison" required maxlength="50" autocomplete="name">
        <div class="invalid-feedback">Enter a display name.</div>
      </div>
      <div class="col-sm-6">
        <label for="bpf-set-user" class="form-label">Username</label>
        <div class="input-group has-validation">
          <span class="input-group-text">@</span>
          <input type="text" class="form-control" id="bpf-set-user" value="nadia.e" required pattern="[a-z0-9._]{3,20}" aria-describedby="bpf-set-user-help" autocomplete="username">
          <div class="invalid-feedback">3 to 20 lowercase letters, numbers, dots or underscores.</div>
        </div>
        <div class="form-text" id="bpf-set-user-help">wpdesk.example/@yourname</div>
      </div>
      <div class="col-12">
        <label for="bpf-set-email" class="form-label">Email</label>
        <input type="email" class="form-control" id="bpf-set-email" value="nadia@wpdesk.example" required autocomplete="email">
        <div class="invalid-feedback">Enter a valid email address.</div>
      </div>
      <div class="col-12">
        <label for="bpf-set-bio" class="form-label">Bio</label>
        <textarea class="form-control" id="bpf-set-bio" rows="3" maxlength="160" aria-describedby="bpf-set-bio-count">Illustrator and part-time letterpress printer. Draws maps for travel guides.</textarea>
        <div class="form-text text-end" id="bpf-set-bio-count">76 / 160</div>
      </div>
    </div>
  </div>
  <div class="card-footer bg-transparent d-flex flex-wrap align-items-center gap-2 py-3">
    <p class="small text-success mb-0 me-auto" id="bpf-set-status" role="status"></p>
    <button type="reset" class="btn btn-outline-secondary px-3 py-2">Cancel</button>
    <button type="submit" class="btn btn-primary px-4 py-2" id="bpf-set-save">Save changes</button>
  </div>
</form>

Edit profile modal that updates the card

  • modal
  • aria-labelledby
  • form="..."
  • hide.bs.modal

Click Edit profile, change a field and click Save.

The modal sits next to the card, not inside it, as the docs recommend for fixed elements. It has tabindex="-1", aria-labelledby on the title and a close button with aria-label. The Save button submits the form through its form attribute, and the script copies the values into the card with textContent before hiding the modal through bootstrap.Modal.getInstance().

View code
<div class="card bpf-edit w-100 shadow-sm">
  <div class="card-body p-4">
    <div class="d-flex align-items-start gap-3">
      <span class="bpf-edit-av rounded-circle flex-shrink-0" aria-hidden="true">RA</span>
      <div class="flex-grow-1">
        <h2 class="h5 mb-0" id="bpf-edit-name-out">Rui Almeida</h2>
        <p class="small text-body-secondary mb-2"><i class="bi bi-geo-alt me-1" aria-hidden="true"></i><span id="bpf-edit-city-out">Porto, Portugal</span></p>
        <p class="mb-0" id="bpf-edit-bio-out">Landscape architect. Designs public gardens that survive both drought and teenagers.</p>
      </div>
    </div>
  </div>
  <div class="card-footer bg-transparent">
    <button type="button" class="btn btn-outline-primary w-100 py-2" data-bs-toggle="modal" data-bs-target="#bpf-edit-modal" id="bpf-edit-open"><i class="bi bi-pencil me-2" aria-hidden="true"></i>Edit profile</button>
  </div>
</div>
<div class="modal fade" id="bpf-edit-modal" tabindex="-1" aria-labelledby="bpf-edit-title" aria-hidden="true">
  <div class="modal-dialog modal-dialog-centered">
    <div class="modal-content">
      <div class="modal-header">
        <h2 class="modal-title fs-5" id="bpf-edit-title">Edit profile</h2>
        <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
      </div>
      <div class="modal-body">
        <form id="bpf-edit-form" novalidate>
          <div class="mb-3">
            <label for="bpf-edit-name" class="form-label">Name</label>
            <input type="text" class="form-control" id="bpf-edit-name" value="Rui Almeida" required maxlength="50">
            <div class="invalid-feedback">Enter your name.</div>
          </div>
          <div class="mb-3">
            <label for="bpf-edit-city" class="form-label">City</label>
            <input type="text" class="form-control" id="bpf-edit-city" value="Porto, Portugal" maxlength="60">
          </div>
          <div>
            <label for="bpf-edit-bio" class="form-label">Bio</label>
            <textarea class="form-control" id="bpf-edit-bio" rows="3" maxlength="160">Landscape architect. Designs public gardens that survive both drought and teenagers.</textarea>
          </div>
        </form>
      </div>
      <div class="modal-footer">
        <button type="button" class="btn btn-outline-secondary" data-bs-dismiss="modal">Cancel</button>
        <button type="submit" class="btn btn-primary px-4" form="bpf-edit-form">Save</button>
      </div>
    </div>
  </div>
</div>

Profile completeness checklist with progress bar

  • progress
  • list-group-item-action
  • form-check-input
  • aria-valuenow

Tick the open items.

The checklist uses the list group checkbox pattern from the docs: each row is a label that wraps a form-check-input, so the whole row is clickable. A change listener counts the checked boxes and updates the bar width, aria-valuenow and the visible percentage together, then switches the bar to bg-success at 100%.

View code
<div class="card bpf-done w-100 shadow-sm">
  <div class="card-body p-4 pb-3">
    <div class="d-flex justify-content-between align-items-baseline gap-2 mb-2">
      <h2 class="h6 mb-0">Finish your profile</h2>
      <span class="fw-semibold" id="bpf-done-pct">60%</span>
    </div>
    <div class="progress mb-2" role="progressbar" aria-label="Profile completeness" aria-valuenow="60" aria-valuemin="0" aria-valuemax="100" id="bpf-done-bar"><div class="progress-bar" id="bpf-done-fill" style="width: 60%"></div></div>
    <p class="small text-body-secondary mb-0" id="bpf-done-msg" aria-live="polite">Finished profiles show up in client search.</p>
  </div>
  <div class="list-group list-group-flush" id="bpf-done-list">
    <label class="list-group-item list-group-item-action d-flex gap-3 py-3"><input class="form-check-input flex-shrink-0 mt-1" type="checkbox" checked><span><span class="d-block fw-semibold">Add a profile photo</span><span class="small text-body-secondary">A clear face or logo, square crop</span></span></label>
    <label class="list-group-item list-group-item-action d-flex gap-3 py-3"><input class="form-check-input flex-shrink-0 mt-1" type="checkbox" checked><span><span class="d-block fw-semibold">Write a short bio</span><span class="small text-body-secondary">Two sentences about what you do</span></span></label>
    <label class="list-group-item list-group-item-action d-flex gap-3 py-3"><input class="form-check-input flex-shrink-0 mt-1" type="checkbox" checked><span><span class="d-block fw-semibold">Verify your email</span><span class="small text-body-secondary">Done on Oct 2</span></span></label>
    <label class="list-group-item list-group-item-action d-flex gap-3 py-3"><input class="form-check-input flex-shrink-0 mt-1" type="checkbox" id="bpf-done-skills"><span><span class="d-block fw-semibold">Add three skills</span><span class="small text-body-secondary">Helps clients find you in search</span></span></label>
    <label class="list-group-item list-group-item-action d-flex gap-3 py-3"><input class="form-check-input flex-shrink-0 mt-1" type="checkbox" id="bpf-done-link"><span><span class="d-block fw-semibold">Link a portfolio</span><span class="small text-body-secondary">Any public page with your work</span></span></label>
  </div>
</div>

Mini profiles, dark mode and theming

A hover card built on the popover plugin, a developer portfolio in dark mode, a maker profile restyled only through CSS variables and a card that switches its own color mode.

Hover card mini profile with the popover plugin

  • bootstrap.Popover
  • html: true
  • trigger: hover focus
  • customClass

Hover or focus a name.

Each @mention is a button with a popover that opens on hover and on keyboard focus. The popover content is a hidden mini profile in the markup, cloned and passed as a DOM element with html: true, so no HTML strings are built. customClass and --bs-popover-* variables give it card proportions. Keep hover cards free of buttons: their content cannot be reached with the keyboard.

View code
<div class="card bpf-hc w-100 shadow-sm">
  <div class="card-body p-4">
    <p class="small text-body-secondary mb-2">Design review &middot; Checkout flow v3</p>
    <p class="mb-0">Spacing feedback came from <button type="button" class="btn btn-link p-0 align-baseline bpf-hc-mention" data-bpf-card="bpf-hc-ada">@ada.brennan</button>, and <button type="button" class="btn btn-link p-0 align-baseline bpf-hc-mention" data-bpf-card="bpf-hc-sam">@sam.ortiz</button> signed off the copy on Friday.</p>
  </div>
  <div class="d-none" id="bpf-hc-ada">
    <div class="d-flex align-items-center gap-2 mb-2">
      <span class="bpf-hc-av" style="--bpf-av: #5b21b6" aria-hidden="true">AB</span>
      <span><span class="d-block fw-semibold">Ada Brennan</span><span class="d-block small text-body-secondary">Senior UI designer, Dublin</span></span>
    </div>
    <p class="small mb-2">Runs the design system crit every Thursday.</p>
    <p class="small text-body-secondary mb-0"><strong class="text-body">48</strong> reviews &middot; <strong class="text-body">1.2k</strong> followers</p>
  </div>
  <div class="d-none" id="bpf-hc-sam">
    <div class="d-flex align-items-center gap-2 mb-2">
      <span class="bpf-hc-av" style="--bpf-av: #92400e" aria-hidden="true">SO</span>
      <span><span class="d-block fw-semibold">Sam Ortiz</span><span class="d-block small text-body-secondary">UX writer, Austin</span></span>
    </div>
    <p class="small mb-2">Turns error messages into sentences people read.</p>
    <p class="small text-body-secondary mb-0"><strong class="text-body">112</strong> reviews &middot; <strong class="text-body">860</strong> followers</p>
  </div>
</div>

Freelance developer portfolio profile in dark mode

  • data-bs-theme="dark"
  • progress
  • badge
  • --bs-progress-bar-bg

The card inherits data-bs-theme="dark", so card, border, badge and text-body-secondary colors come from the dark palette with no extra CSS. Skills show as bars with the level printed in words next to each one, since a bar alone carries no information. The custom CSS only sets an accent through --bs-progress-bar-bg on .progress (where Bootstrap defines it) and the button variables.

View code
<div class="card bpf-dev w-100">
  <div class="card-body p-4">
    <div class="d-flex flex-wrap align-items-center gap-3 mb-3">
      <svg class="flex-shrink-0" viewBox="0 0 80 80" width="80" height="80" aria-hidden="true">
        <rect width="80" height="80" rx="20" fill="#0f2b2b"/>
        <path d="M28 26 L14 40 L28 54" fill="none" stroke="#2dd4bf" stroke-width="6" stroke-linecap="round" stroke-linejoin="round"/>
        <path d="M52 26 L66 40 L52 54" fill="none" stroke="#2dd4bf" stroke-width="6" stroke-linecap="round" stroke-linejoin="round"/>
        <path d="M45 20 L35 60" stroke="#99f6e4" stroke-width="6" stroke-linecap="round"/>
      </svg>
      <div class="flex-grow-1">
        <h2 class="h5 mb-0">Kofi Mensah</h2>
        <p class="text-body-secondary mb-1">Freelance front-end developer, Accra</p>
        <span class="badge rounded-pill bpf-dev-avail"><i class="bi bi-circle-fill me-1 small" aria-hidden="true"></i>Available from Nov 10</span>
      </div>
    </div>
    <p class="mb-3">Builds fast marketing sites and design system components for small product teams. Usually two clients at a time, never more.</p>
    <div class="d-flex flex-wrap gap-2 mb-4">
      <span class="badge text-bg-secondary fw-normal">TypeScript</span>
      <span class="badge text-bg-secondary fw-normal">React</span>
      <span class="badge text-bg-secondary fw-normal">Astro</span>
      <span class="badge text-bg-secondary fw-normal">Bootstrap</span>
      <span class="badge text-bg-secondary fw-normal">Accessibility audits</span>
    </div>
    <h3 class="h6 text-body-secondary mb-3">Skills</h3>
    <div class="mb-3">
      <div class="d-flex justify-content-between small mb-1"><span>CSS architecture</span><span class="text-body-secondary">Expert, 9 yrs</span></div>
      <div class="progress" role="progressbar" aria-label="CSS architecture, expert" aria-valuenow="95" aria-valuemin="0" aria-valuemax="100"><div class="progress-bar" style="width: 95%"></div></div>
    </div>
    <div class="mb-3">
      <div class="d-flex justify-content-between small mb-1"><span>JavaScript and TypeScript</span><span class="text-body-secondary">Advanced, 7 yrs</span></div>
      <div class="progress" role="progressbar" aria-label="JavaScript and TypeScript, advanced" aria-valuenow="80" aria-valuemin="0" aria-valuemax="100"><div class="progress-bar" style="width: 80%"></div></div>
    </div>
    <div class="mb-4">
      <div class="d-flex justify-content-between small mb-1"><span>Motion and animation</span><span class="text-body-secondary">Working, 3 yrs</span></div>
      <div class="progress" role="progressbar" aria-label="Motion and animation, working knowledge" aria-valuenow="55" aria-valuemin="0" aria-valuemax="100"><div class="progress-bar" style="width: 55%"></div></div>
    </div>
    <div class="d-flex flex-wrap align-items-center gap-2 border-top pt-3">
      <p class="mb-0 me-auto"><span class="fs-4 fw-bold">$85</span> <span class="text-body-secondary">/ hour</span></p>
      <div class="d-flex gap-2">
        <a href="#" class="btn btn-outline-light py-2"><i class="bi bi-file-earmark-text me-1" aria-hidden="true"></i>CV</a>
        <a href="#" class="btn bpf-dev-hire px-4 py-2">Hire Kofi</a>
      </div>
    </div>
  </div>
</div>

Maker profile themed with CSS variables only

  • --bs-card-*
  • --bs-btn-*
  • --bs-border-radius
  • card-img-top

Every color, radius and font on this card comes from Bootstrap 5.3 CSS variables set on one prefixed wrapper: --bs-card-bg and --bs-card-border-color for the paper look, --bs-btn-* for the terracotta button, --bs-border-radius for the softer corners and a serif stack on the headings. The markup is ordinary card, badge and button classes.

View code
<div class="card bpf-maker w-100">
  <img src="red-rock-canyon.webp" class="card-img-top bpf-maker-cover object-fit-cover" alt="" width="800" height="600">
  <div class="card-body p-4">
    <svg class="bpf-maker-av" viewBox="0 0 80 80" width="80" height="80" aria-hidden="true">
      <circle cx="40" cy="40" r="40" fill="#fbf6ee"/>
      <circle cx="40" cy="40" r="34" fill="#9a3412"/>
      <path d="M26 30 C26 24 54 24 54 30 L50 58 C49 62 31 62 30 58 Z" fill="#fed7aa"/>
      <ellipse cx="40" cy="30" rx="14" ry="4" fill="#7c2d12"/>
    </svg>
    <div class="d-flex flex-wrap justify-content-between align-items-start gap-2 mt-2">
      <div>
        <h2 class="bpf-maker-title h4 mb-0">Elena Marsh</h2>
        <p class="mb-0 bpf-maker-muted">Studio Alba Ceramics, Santa Fe</p>
      </div>
      <span class="badge rounded-pill bpf-maker-badge">Commissions open</span>
    </div>
    <p class="my-3">Wheel-thrown tableware in local red clay, glazed in small batches. Teaches a six-week beginner course every season.</p>
    <ul class="list-unstyled row row-cols-3 g-2 mb-4">
      <li class="col"><span class="d-block bpf-maker-title fs-4">340</span><span class="small bpf-maker-muted">Pieces sold</span></li>
      <li class="col"><span class="d-block bpf-maker-title fs-4">12</span><span class="small bpf-maker-muted">Courses taught</span></li>
      <li class="col"><span class="d-block bpf-maker-title fs-4">4.9</span><span class="small bpf-maker-muted">Average rating</span></li>
    </ul>
    <div class="d-flex flex-wrap gap-2">
      <a href="#" class="btn bpf-maker-btn px-4 py-2">Book a class</a>
      <a href="#" class="btn bpf-maker-ghost px-4 py-2">View the shop</a>
    </div>
  </div>
</div>

Profile card that switches its own color mode

  • data-bs-theme
  • bg-body-tertiary
  • link-body-emphasis
  • aria-pressed

Click the moon button.

Bootstrap 5.3 color modes work on any element, so the toggle sets data-bs-theme on the card alone and every adaptive class inside it (bg-body-tertiary, text-body-secondary, border, link-body-emphasis, btn-outline-secondary) switches with it. The button is a toggle with aria-pressed and an icon swap; no colors are hard-coded.

View code
<div class="card bpf-mode w-100 shadow-sm" id="bpf-mode-card" data-bs-theme="light">
  <div class="card-body p-4">
    <div class="d-flex align-items-start gap-3 mb-3">
      <span class="bpf-mode-av rounded-circle flex-shrink-0" aria-hidden="true">RC</span>
      <div class="flex-grow-1">
        <h2 class="h5 mb-0">Rafael Cruz</h2>
        <p class="small text-body-secondary mb-0">Host of Night Shift Radio</p>
      </div>
      <button type="button" class="btn btn-outline-secondary bpf-mode-btn" id="bpf-mode-btn" aria-pressed="false" aria-label="Dark mode"><i class="bi bi-moon-stars" aria-hidden="true" id="bpf-mode-icon"></i></button>
    </div>
    <p>A weekly show about people who work while the city sleeps: bakers, nurses, bridge inspectors.</p>
    <div class="bg-body-tertiary border rounded-3 p-3 mb-3">
      <p class="small text-body-secondary mb-1">Latest episode</p>
      <p class="fw-semibold mb-1">The tunnel crew that never sees daylight</p>
      <p class="small text-body-secondary mb-0"><i class="bi bi-clock me-1" aria-hidden="true"></i>48 min &middot; Oct 24</p>
    </div>
    <div class="d-flex flex-wrap gap-3 small">
      <a href="#" class="link-body-emphasis"><i class="bi bi-globe me-1" aria-hidden="true"></i>nightshift.example</a>
      <a href="#" class="link-body-emphasis"><i class="bi bi-envelope me-1" aria-hidden="true"></i>Send a story</a>
    </div>
  </div>
</div>

What is a Bootstrap profile, and how does it differ from a standard card?

Avatar, name, bio, stats and action buttons, arranged in a responsive layout built from Bootstrap’s card, grid and utility classes. That’s the whole pattern.

It lives entirely in the front-end layer. Markup, classes and a little JavaScript, with no server logic attached.

The term covers a lot of ground. Sometimes it means a single card for one person in a team grid or directory, sometimes a full page with a header, tabs and settings. Ready-made pages or kits you copy into a project get the same label.

A plain Bootstrap card is a generic container. Per the Bootstrap 5.3 documentation, it assumes no specific width and fills 100% of its parent unless you set one.

A profile adds identity data and person-specific controls on top of that container.

AspectStandard cardBootstrap profile
ContentTitle, text, image capAvatar, name, role, bio, stats
ActionsOne buttonFollow, message or edit, plus social links
LayoutSingle columnAvatar column and details column at md
Data modelAny contentOne person or organization

The phrase also exists outside web design. Microsoft’s Win32 documentation uses “bootstrap profile” for a Wi-Fi sample that lets a computer authenticate to a wireless network before it has joined a domain, and eSIM vendors such as Wireless Logic use it for the first connectivity profile loaded onto a SIM.

Neither has anything to do with the UI pattern covered here.

Which Bootstrap components make up a profile?

Card, list group, badge, progress bar and nav tabs cover most of it, with grid and flex utilities deciding where everything sits.

The card, card-body and card-header classes form the outer container and the name block. A list group handles contact rows like email, phone and location. Badges label the role or status, and progress bars show skill or completion levels. Nav tabs switch between activity, projects and settings.

Those pieces fill up to 5 sections: header or cover, bio, stats row, contact list and activity area. A team directory card usually stops after the first three.

Social and contact icons come from an icon set. The Bootstrap Icons library ships separately from the framework CSS, and Font Awesome is the usual alternative.

MDB’s profile documentation describes a user page with a circular picture in the header, a projects section with social icons, an address block and experience cards that use progress bars to show skill level.

One caution on that last piece. A skill bar is decoration until the value also appears as text next to it.

How the grid splits a profile across breakpoints

Use col-md-4 and col-md-8 to split a profile into a sidebar and a details column. Below the md breakpoint the two stack into one.

Bootstrap writes every breakpoint as a minimum width, which makes the system mobile-first. A class like col-md-4 applies from the md width upward, and below it the column runs full width.

The Bootstrap 5.3 documentation sets the minimum widths at 576px for sm, 768px for md, 992px for lg, 1200px for xl and 1400px for xxl. Extra small (xs) starts at 0 and needs no media query.

Bootstrap’s 12-column grid system nests. Wrap the layout in a container, then a row, then the columns. Put the stats row inside the details column as its own nested row, so the counters divide that column’s width instead of the page’s.

For the avatar and name block, d-flex with align-items-center and gap-3 lines everything up without extra columns. The gap utilities work on any flex or grid parent, according to the spacing docs.

Fixed stat blocks are the usual failure. A col-4 with no breakpoint applies from 0 and up, so three counters stay side by side at 320px and long labels wrap into narrow strips. Use row-cols-1 row-cols-sm-3 on the stats row instead.

Avatar and cover image styling

The rounded-circle class turns a square image into a circle, and a non-square image into an oval.

That matters because img-fluid, which applies max-width: 100% and height: auto per Bootstrap’s image docs, keeps the aspect ratio of the source file. A 4:3 upload stays 4:3 and the circle breaks. Set only a width and the height follows the image, so the shape drifts. Mixed upload sizes make it worse, since each one crops differently from profile to profile.

I’d skip img-fluid on the avatar entirely. Give it a fixed width and height (150px is common) and add object-fit: cover in CSS, so the browser crops instead of squashing.

The cover image is the opposite case. It should scale with the card, so img-fluid fits, and card-img-top rounds its top corners to match the card border.

Adding img-thumbnail to the avatar gives it a padded 1px border, which reads as a white ring when the avatar overlaps a dark cover.

Overlapping the cover is where Bootstrap 5 trips people up. Negative margin utilities such as mt-n5 are off by default, and setting $enable-negative-margins to true in Sass turns them on.

Without that switch, position the avatar with position-absolute and one line of custom CSS.

Adding tabs, an edit modal and dropdown actions

Nav tabs, a modal and a dropdown give a static profile some behavior. All three run on Bootstrap’s JavaScript, so load bootstrap.bundle.min.js, which includes Popper.

The dropdown holds secondary actions like share, report and block, so the card header keeps a single primary button. Bootstrap’s docs state that dropdowns toggle on click, not on hover, by design.

Tabs for profile sections

Tabs split a long profile into Activity, Projects and Settings panes without a page reload.

Bootstrap’s tab component pairs a nav-tabs list with tab-pane panels and a data-bs-toggle attribute on each trigger. The 5.3 docs add a warning: a nav-tabs bar that links to other pages must not receive role=”tablist”, role=”tab” or role=”tabpanel”.

Those roles belong only to dynamic tabbed interfaces that follow the ARIA Authoring Practices Guide tabs pattern, and Bootstrap’s script sets aria-selected on the active tab itself.

Edit profile modal

The markup needs tabindex=”-1″ on the .modal element, aria-labelledby pointing at the modal title, and a close button with aria-label=”Close”. The trigger button uses data-bs-toggle=”modal” and data-bs-target.

Inside, the form holds name, bio and contact fields, and the header carries the dismiss action Bootstrap’s docs ask for.

An edit form fits a Bootstrap modal well, with one placement rule. The modal docs warn of issues when a .modal is nested inside another fixed element, so put the modal markup at the top level of the body, not inside the profile card.

How to build a basic profile card step by step

Page setup, card container, avatar, identity text, stats row and action buttons. Do them in that order.

  1. Start the page with the HTML5 doctype and the viewport meta tag, link the Bootstrap CSS in the head, and load the JS bundle before the closing body tag. The current 5.3 docs pull both files from jsDelivr pinned to 5.3.8, and pinning a version beats a floating “latest”.
  2. Wrap the card in a container, a row and a column such as col-md-6 col-lg-4, so it sizes with the grid instead of a fixed pixel width.
  3. Add the avatar: a square image with rounded-circle and a fixed width and height, centered with text-center on the card body.
  4. Add the name in card-title and the role as a quieter line beneath it.
  5. Add the stats row: a nested row with three col-4 counters such as posts, followers and following. A card is already narrow, so three across works here.
  6. Finish with two buttons, one filled for the main action and one outline for the secondary one.

The mistakes that show up most are a missing viewport meta tag, which makes phones render the desktop width, and a missing JS bundle, which leaves tabs, modals and dropdowns doing nothing. Columns that add up past 12 also wrap onto a new line.

The viewport tag is easy to miss, and the symptom looks like a CSS bug. The card simply renders at desktop width on a phone.

Without the doctype, Bootstrap’s own docs warn, styling comes out incomplete.

Check the finished card just below and just above the md breakpoint before adding anything else.

Bootstrap 4 and Bootstrap 5 differences in profile code

Bootstrap 4 profile code breaks in Bootstrap 5 mostly because jQuery is gone, data attributes carry a bs- prefix, left and right spacing became start and end, the media object was dropped, and the gutters changed.

AreaBootstrap 4Bootstrap 5
JavaScriptjQuery pluginsPlain JavaScript, no jQuery
Data attributesdata-toggle, data-targetdata-bs-toggle, data-bs-target
Horizontal spacingml-3, mr-3ms-3, me-3
Avatar beside text.media componentd-flex utilities
Gutters.no-gutters, 30px.g-0, 1.5rem (about 24px)

All five rows come from Bootstrap’s v5 migration guide. The gutter change is the quiet one. With narrower gutters, a v4 profile snippet sits tighter than its original once it runs on v5.

Dropping jQuery matters most for tabs, modals and dropdowns, the parts of a profile that actually do something. They now run on plain JavaScript, so a page with no other jQuery use can remove the library.

The same guide drops Internet Explorer 10 and 11, which narrows the cross-browser compatibility target to modern browsers.

Bootstrap’s maintainers set Bootstrap 4 end of life for January 1, 2023 (Bootstrap blog, 2022). OpenLogic’s LTS notes add that versions 3 and 4 no longer receive new features, updates or security fixes.

Two free templates both named Profile show the gap. Themewagon’s portfolio template lists Bootstrap 4, Font Awesome, Google Fonts and jQuery as its stack, while UICookies’ Profile resume template is hand-written Bootstrap 5 with vanilla JavaScript and zero jQuery.

To spot an old template quickly, search it for data-toggle where data-bs-toggle should be, for ml- and mr- spacing classes, or for a jquery script tag.

Making a Bootstrap profile accessible

Alt text for the images, contrast for text on colored or photo backgrounds, and accessible names for icon-only links get you most of the way on a profile.

An avatar sitting beside the name repeats what the text already says, so W3C’s alt decision tree points to an empty alt (alt=””). A standalone avatar gets a short description, such as the person’s name. If the avatar links to a full profile, it counts as a functional image, so the alt names the destination, not the picture. The cover photo is decorative, so alt=”” there too.

WCAG success criterion 1.4.3 sets the floor at 4.5:1 for normal text and 3:1 for large text, meaning 18pt or 14pt bold (W3C).

Ratios are computed, not rounded, so 4.499:1 fails. That makes color contrast a number to measure with a checker, not something to judge by eye.

Bootstrap’s accessibility documentation warns that parts of its default palette fall below the recommended contrast on light backgrounds, so test badge and button colors yourself.

Text laid directly over a cover photo is the usual failure, and W3C lists background images without sufficient contrast as failure technique F83. A dark overlay or a solid text panel fixes it.

Social links built from icons alone have no name. Bootstrap’s docs provide the .visually-hidden class for text that screen readers read and sighted users do not see, so put the network name inside it.

A full audit belongs on a web accessibility checklist, which covers more than a profile section needs.

Which template or UI kit to start from

A single card snippet is enough for a team grid, and a full profile template suits a standalone page. An admin kit only makes sense when the profile lives inside a dashboard.

A lone card needs nothing beyond core Bootstrap components, so a kit adds weight without adding anything there.

OptionBuilt onBest for
MDB Bootstrap profilesBootstrap 5 through the MDB UI kitCopy-paste cards and pages
BootstrapBrain templateBootstrap 5One standalone profile page
Start BootstrapBootstrap, MIT licenseStarter page shells
AdminLTEBootstrap 5, MIT licenseProfile inside an admin dashboard
TablerBootstrap 5, MIT licenseDashboard with dark mode

MDB Bootstrap profiles

The mdbootstrap/bootstrap-profiles repository describes its set as Bootstrap 5 profiles with followers, avatars, comments, stats and social media. Its how-to says to download the free MDB 5 UI kit and paste the code into an MDB project.

You get many variants in one place (card profile, user profile page, profile form), a copy-and-paste workflow and a React edition of the same set.

The catch is that the how-to assumes an MDB project, so check each snippet for MDB-specific components or attributes before pasting it into plain Bootstrap (the basic profile card uses only standard Bootstrap classes). It also puts one more layer between your markup and Bootstrap’s documentation.

BootstrapBrain Free Profile Template

BootstrapBrain lists this Bootstrap 5 page template with sections for personal or company details, bios, skills and social links. One page covers most profile sections with little setup, and it is built to be customized.

It’s a single layout, not a component set, and the current version loads BootstrapBrain’s own BSB Framework on top of Bootstrap 5.3.3. The listing also doesn’t spell out license terms for the free version, so read them before commercial use.

Start Bootstrap

Start Bootstrap’s README states that its free templates and themes are released under the MIT license, usable for any purpose including commercial projects. Licensing is clean, and npm start gives a live-reload preview while you edit.

The nearest fit for a profile is the Resume theme. Its GitHub description and package.json still call it a Bootstrap 4 theme, but the package depends on Bootstrap 5.2.3 (v7.0.6), so expect an older 5.2 build without the 5.3 color modes rather than a data-toggle migration.

AdminLTE

AdminLTE gives you a full dashboard shell on Bootstrap 5.3 under the MIT license, with no jQuery. v4 reached its stable 4.0.0 release in May 2026. Sidebar navigation, account areas and a demo Profile page come already laid out.

Moving from v3 is a rewrite, though. v4 drops jQuery, renames classes and data attributes, and no longer bundles the old jQuery plugins, according to AdminLTE’s own README and migration guide.

The kit’s sidebar runs on data-lte-toggle attributes, so a generic Bootstrap sidebar tutorial needs translating before it applies.

Tabler

Tabler is the pick when the profile sits in a dashboard that needs dark mode. It has a Bootstrap 5 base, an MIT license, Sass customization and, per Tabler’s site, 100+ UI components.

A dashboard kit is a lot of surface for one profile. Commercial use is fine, though: Tabler’s FAQ says the MIT license only asks you to keep the license and copyright notices in your copy.

When a Bootstrap profile is the wrong choice

Skip it when the profile needs data handling Bootstrap does not provide, a design far from Bootstrap’s defaults, or a page that mixes Bootstrap versions.

Bootstrap ships markup, classes and a few plugins. An edit modal collects input and stores nothing. A profile picture upload and account checks need server code, and anything that touches stored data belongs to the backend. The Bootstrap layer only displays it.

A design that fights the defaults lands in override territory. Overriding Bootstrap CSS works through Sass variables or later-loaded rules, and each override is one more thing to recheck at every upgrade.

Mixed versions are sneakier. A Bootstrap 4 snippet pasted into a Bootstrap 5 page renders fine, then a data-toggle button does nothing when clicked.

Bootstrap also has no data binding. A long directory of profiles needs a template engine or framework generating the cards.

In those cases a plain card with custom CSS is the smaller commitment.

Bootstrap profile FAQ

Can I use a free Bootstrap profile template in a commercial project?

Only when the license allows it, so read the LICENSE file first. MIT, the license on Start Bootstrap, AdminLTE and Tabler, permits commercial use.

AdminLTE’s README adds that its maintainers reserve the right to change the license of future releases.

How do I add a profile picture upload?

Put a file input styled with form-control inside the edit modal, and preview the chosen image in the avatar with the browser’s FileReader API or URL.createObjectURL().

Saving the file is a separate job. It needs server-side handling that Bootstrap does not provide.

How do I add hover effects to a profile card?

Write a small custom class with a transition and a :hover rule, because Bootstrap ships no hover variant for cards.

A lift of a few pixels plus a deeper box-shadow is the usual pattern, and these card hover effects cover more variations.

Does a Bootstrap profile support dark mode?

Yes, in Bootstrap 5.3 and later. Set data-bs-theme=”dark” on the html element or on a single card.

Colored link helpers do not adapt to the mode, with link-body-emphasis the one exception, per the 5.3 docs.

How do I change the colors with Sass?

Override the Sass variables before the Bootstrap import, because Bootstrap declares them with !default and keeps whatever value is already set.

Changing $primary recolors every primary component in the profile, buttons and progress bars included.

Which layout works best for a team member card?

Reuse the profile card structure, drop the stats row, and place each card in a column of a row with row-cols-1 row-cols-md-3 g-4.

Keep to name, role badge and social icons. A tidy card layout repeats the same elements in the same order on every card.

Does Bootstrap profile code work in React?

Yes. Bootstrap’s CSS works on React markup as is, with className replacing class.

Bootstrap’s own JavaScript edits the DOM directly, so React projects usually pick a wrapper such as React Bootstrap or MDB’s React edition for tabs, modals and dropdowns. The steps for adding Bootstrap to Next.js follow the same split.

Choosing Where to Start With a Bootstrap Profile

Start from the Bootstrap version, not the layout. The version fixes every attribute name, spacing class and script call built on top of it.

After that comes the grid and avatar layout, then behavior, then contrast and alt text. Layout and accessibility fixes are cheap to repeat. A version mismatch forces a rewrite of everything built on it.

Maintenance has a price too. Bootstrap 4 ran 5 years before end of life (OpenLogic), and Bootstrap 5, released in May 2021, had already passed that mark by October 2026.

As of October 2026, HeroDevs lists Bootstrap 5 as the only major version still receiving updates, and the 5.3 docs already refer to a future v6. Pin the CDN version and budget a migration, since a Bootstrap 5 end-of-life date or a v6 release changes this advice.