--- layout: docs title: Migrating to v4 group: migration --- Bootstrap 4 is a major rewrite of almost the entire project. The most notable changes are summarized immediately below, followed by more specific class and behavioral changes to relevant components. {% callout info %} **Heads up!** This will be in flux as work on the v4 alphas progresses. Until then consider it incomplete, and we'd love pull requests to help keep it up to date. {% endcallout %} ## Summary Here are the big ticket items you'll want to be aware of when moving from v3 to v4. ### Browser support - Dropped IE8 and iOS 6 support. v4 is now only IE9+ and iOS 7+. For sites needing either of those, use v3. - Added official support for Android v5.0 Lollipop's Browser and WebView. Earlier versions of the Android Browser and WebView remain only unofficially supported. ### Global changes - Switched from [Less](http://lesscss.org/) to [Sass](http://sass-lang.com/) for our source CSS files. - Switched from `px` to `rem` as our primary CSS unit, though pixels are still used for media queries and grid behavior as viewports are not affected by type size. - Global font-size increased from `14px` to `16px`. - Added a new grid tier for ~`480px` and below. - Replaced the separate optional theme with configurable options via SCSS variables (e.g., `$enable-gradients: true`). ### Grid system - Added support for flexbox (set `$enable-flex: true` and recompile) in the grid mixins and predefined classes. - As part of flexbox, included support for vertical and horizontal alignment classes. - Overhauled grid mixins to merge `make-col-span` into `make-col` for a singular mixin. - Added a new `sm` grid tier below `768px` for more granular control. We now have `xs`, `sm`, `md`, `lg`, and `xl`. This also means every tier has been bumped up one level (so `.col-md-6` in v3 is now `.col-lg-6` in v4). - Changed grid system media query breakpoints and container widths to account for new grid tier and ensure columns are evenly divisible by `12` at their max width. - Grid breakpoints and container widths are now handled via Sass maps (`$grid-breakpoints` and `$container-max-widths`) instead of a handful of separate variables. These replace the `@screen-*` variables entirely and allow you to fully customize the grid tiers. - Media queries have also changed. Instead of repeating our media query declarations with the same value each time, we now have `@include media-breakpoint-up/down/only`. Now, instead of writing `@media (min-width: @screen-sm-min) { ... }`, you can write `@include media-breakpoint-up(sm) { ... }`. ### Components - Dropped panels, thumbnails, and wells for a new all-encompassing component, cards. - Dropped the Glyphicons icon font. If you need icons, some options are: - the upstream version of [Glyphicons](http://glyphicons.com/) - [Octicons](https://octicons.github.com/) - [Font Awesome](https://fortawesome.github.io/Font-Awesome/) - Dropped the Affix jQuery plugin. We recommend using a `position: sticky` polyfill instead. [See the HTML5 Please entry](http://html5please.com/#sticky) for details and specific polyfill recommendations. - If you were using Affix to apply additional, non-`position` styles, the polyfills might not support your use case. One option for such uses is the third-party [ScrollPos-Styler](https://github.com/acch/scrollpos-styler) library. - Dropped the pager component as it was essentially slightly customized buttons. - Refactored nearly all components to use more un-nested classes instead of children selectors. ### Misc - Non-responsive usage of Bootstrap is no longer supported. - Dropped the online Customizer in favor of more extensive setup documentation and customized builds. ## By component This list highlights key changes by component between v3.x.x and v4.0.0. ### Reboot New to Bootstrap 4 is the Reboot, a new stylesheet that builds on Normalize with our own somewhat opinionated reset styles. Selectors appearing in this file only use elements—there are no classes here. This isolates our reset styles from our component styles for a more modular approach. Some of the most important resets this includes are the `box-sizing: border-box` change, moving from `em` to `rem` units on many elements, link styles, and many form element resets. ### Typography - Moved all `.text-` utilities to the `_utilities.scss` file. - Dropped `.page-header` as, aside from the border, all it's styles can be applied via utilities. - `.dl-horizontal` has been dropped. Instead, use `.row` on `
` and use grid column classes (or mixins) on its `
` and `
` children. - Custom `
` styling has moved to classes—`.blockquote` and the `.blockquote-reverse` modifier. - `.list-inline` now requires that its children list items have the new `.list-inline-item` class applied to them. ### Images - Renamed `.img-responsive` to `.img-fluid`. ### Tables - Nearly all instances of the `>` selector have been removed, meaning nested tables will now automatically inherit styles from their parents. This greatly simplifies our selectors and potential customizations. - Responsive tables no longer require a wrapping element. Instead, just put the `.table-responsive` right on the ``. - Renamed `.table-condensed` to `.table-sm` for consistency. - Added a new `.table-inverse` option. - Added a new `.table-reflow` option. - Added table header modifiers: `.thead-default` and `.thead-inverse` ### Forms - Moved element resets to the `_reboot.scss` file. - Renamed `.control-label` to `.form-control-label`. - Renamed `.input-lg` and `.input-sm` to `.form-control-lg` and `.form-control-sm`, respectively. - Dropped `.form-group-*` classes for simplicity's sake. Use `.form-control-*` classes instead now. - Dropped `.help-block` and replaced it with `.form-text` for block-level help text. For inline help text and other flexible options, use utility classes like `.text-muted`. - Horizontal forms overhauled: - Dropped the `.form-horizontal` class requirement. - `.form-group` no longer applies styles from the `.row` via mixin, so `.row` is now required for horizontal grid layouts (e.g., `
`). - Added new `.form-control-label` class to vertically center labels with `.form-control`s. ### Buttons - Renamed `.btn-default` to `.btn-secondary`. - Dropped the `.btn-xs` class entirely as `.btn-sm` is proportionally much smaller than v3's. - The [stateful button](http://getbootstrap.com/javascript/#buttons-methods) feature of the `button.js` jQuery plugin has been dropped. This includes the `$().button(string)` and `$().button('reset')` methods. We advise using a tiny bit of custom JavaScript instead, which will have the benefit of behaving exactly the way you want it to. - Note that the other features of the plugin (button checkboxes, button radios, single-toggle buttons) have been retained in v4. ### Button group - Dropped the `.btn-group-xs` class entirely given removal of `.btn-xs`. ### Dropdowns - Switched from parent selectors to singular classes for all components, modifiers, etc. - Simplified dropdown styles to no longer ship with upward or downward facing arrows attached to the dropdown menu. - Dropdowns can be built with `
`s or `