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.
| Aspect | Standard card | Bootstrap profile |
|---|
| Content | Title, text, image cap | Avatar, name, role, bio, stats |
| Actions | One button | Follow, message or edit, plus social links |
| Layout | Single column | Avatar column and details column at md |
| Data model | Any content | One 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.
- 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”.
- 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.
- Add the avatar: a square image with rounded-circle and a fixed width and height, centered with text-center on the card body.
- Add the name in card-title and the role as a quieter line beneath it.
- 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.
- 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.
| Area | Bootstrap 4 | Bootstrap 5 |
|---|
| JavaScript | jQuery plugins | Plain JavaScript, no jQuery |
| Data attributes | data-toggle, data-target | data-bs-toggle, data-bs-target |
| Horizontal spacing | ml-3, mr-3 | ms-3, me-3 |
| Avatar beside text | .media component | d-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.
| Option | Built on | Best for |
|---|
| MDB Bootstrap profiles | Bootstrap 5 through the MDB UI kit | Copy-paste cards and pages |
| BootstrapBrain template | Bootstrap 5 | One standalone profile page |
| Start Bootstrap | Bootstrap, MIT license | Starter page shells |
| AdminLTE | Bootstrap 5, MIT license | Profile inside an admin dashboard |
| Tabler | Bootstrap 5, MIT license | Dashboard 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.