Bootstrap 5 Background Image
Tags: bootstrap, javascript, webdev, html
Published: 2021-03-29 14:06:11

## What is Bootstrap Background Image?

Bootstrap Background Image allows you to set any photo as a background, by default, a background-image is placed at the top-left corner of an element, and repeated both vertically and horizontally.

______

## Installation

#### Manual installation (zip package)

To use this component, you first need to install the [MDB 5 Free package](https://mdbootstrap.com/docs/standard/getting-started/installation/#section-manual-installation)

_______

#### MDB CLI

Watch our [**Quick Start Tutorial**](https://mdbootstrap.com/docs/standard/getting-started/quick-start/) to discover and use the full potential of MDB 5 and MDB CLI

_______

#### NPM

###### Prerequisites

Before starting the project make sure to install [Node LTS (12.x.x recommended)](https://nodejs.org/en/).

###### Installation

To install MDB UI KIT in your project easily type the following command in the terminal:
```terminal
npm i mdb-ui-kit 
```

###### Importing JS modules

You can import the entire library or just individual modules:
```terminal
import * as mdb from 'mdb-ui-kit'; // lib
import { Input } from 'mdb-ui-kit'; // module 
```

###### Importing CSS file

To import MDB stylesheet please use the following syntax:
```terminal
@import '~mdb-ui-kit/css/mdb.min.css'; 
```

###### Importing SCSS modules

You can also import individual SCSS modules. To do it properly, we recommend to copy them from the node_modules/mdb-ui-kit/src/scss location directly to your project and import in the same way as CSS files.

###### Webpack integration

You can significantly speed up the process of creating a new project based on Webpack using our [Starter](https://github.com/mdbootstrap/mdb-webpack-starter).

__________

#### CDN

Installation via CDN is one of the easiest methods of integrating MDB UI KIT with your project. Just copy the latest compiled JS script tag and CSS link tag from [cdnjs](https://cdnjs.com/libraries/mdb-ui-kit) to the application.

Don't forget to add also Font Awesome and Roboto font if you need. Here's an example code:

###### CSS

```css
<!-- Font Awesome -->
<link
  href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.15.1/css/all.min.css"
  rel="stylesheet"
/>
<!-- Google Fonts -->
<link
  href="https://fonts.googleapis.com/css?family=Roboto:300,400,500,700&display=swap"
  rel="stylesheet"
/>
<!-- MDB -->
<link
  href="https://cdnjs.cloudflare.com/ajax/libs/mdb-ui-kit/3.3.0/mdb.min.css"
  rel="stylesheet"
/>
```


###### JS

```javascript
<!-- MDB -->
<script
  type="text/javascript"
  src="https://cdnjs.cloudflare.com/ajax/libs/mdb-ui-kit/3.3.0/mdb.min.js"
></script>
```



______

## Getting started

Setting a background image in Bootstrap can seem troublesome, especially for novice web developers.

Try these ready-to-use templates to see how you can implement the background image in a real project.

- [Full page background image](https://mdbootstrap.com/snippets/standard/mdbootstrap/2515521?view=side)
- [Full page carousel](https://mdbootstrap.com/snippets/standard/mdbootstrap/2515519?view=side)
- [Half page carousel](https://mdbootstrap.com/snippets/standard/mdbootstrap/2515536?view=side)
- [Full page video background](https://mdbootstrap.com/snippets/standard/mdbootstrap/2515523?view=side)
- [Half page video background](https://mdbootstrap.com/snippets/standard/mdbootstrap/2515539?view=side)
- [Login page with background image](https://mdbootstrap.com/snippets/standard/mdbootstrap/2515540?view=side)


____________

## Customization

###### How it works

You can easily set the background image in each HTML element by adding a single line of CSS:

```css
style="background-image: url('');

```
Inside of the url('') we need to provide a link to our image.


##### Basic example

This is a basic example of a full-page background image. If you need a background image with different settings have a look at other sections of this docs.

1. Add `background-image` via inline CSS.
2. Define the background height. In the example below, we use `vh` units, which stands for "viewport height" (`height: 100vh` means 100% of available height.)
3. Add `.bg-image` class to scale the image properly and to enable responsiveness


```html
<!-- Background image -->
<div class="bg-image"
style="background-image: url('https://mdbcdn.b-cdn.net/img/Photos/Others/images/76.jpg');
      height: 100vh">
</div>
<!-- Background image -->

```

##### Jumbotron with background image

In bootstrap 5 there is no dedicated jumbotron component, but it's not a problem at all. You can easily create your own component by using available classes.


```html
<!-- Jumbotron -->
<div class="bg-image p-5 text-center shadow-1-strong rounded mb-5 text-white"
    style="background-image: url('https://mdbcdn.b-cdn.net/img/new/slides/003.jpg');">
  <h1 class="mb-3 h2">Jumbotron</h1>

  <p>Lorem ipsum dolor, sit amet consectetur adipisicing elit. Repellendus praesentium labore accusamus sequi, voluptate debitis tenetur in deleniti possimus modi voluptatum neque maiores dolorem unde? Aut dolorum quod excepturi fugit.</p>

</div>
<!-- Jumbotron -->

```






#### You can see more customization examples on the [📄 Background Image documentation page](https://mdbootstrap.com/docs/standard/content-styles/background-image/)








----

## Crucial Resources

Here are the resources that we have prepared to help you work with this component:

1. Read [📄 Background Image tutorial & documentation](https://mdbootstrap.com/docs/standard/content-styles/background-image/) <-- start here
2. In to get the most out of your project, you should also get acquainted with other Content & style options related to Background Image. See the section below to find the list of them.
3. You can use predesigned Content & style elements in [📥 Starter Bootstrap 5 templates](https://mdbootstrap.com/freebies/)
4. Templates are a part of [📦 Free UI Kit for Bootstrap 5](https://mdbootstrap.com/docs/standard/)
5. After finishing the project you can publish it with CLI in order to receive [💽 Free hosting (beta)](https://mdbootstrap.com/docs/standard/cli/)

-----

## Related Content and Styles options & features
- [Theme](https://mdbootstrap.com/docs/standard/content-styles/theme/)
- [Animations](https://mdbootstrap.com/docs/standard/content-styles/animations/)
- [Colors](https://mdbootstrap.com/docs/standard/content-styles/colors/)
- [Figures](https://mdbootstrap.com/docs/standard/content-styles/figures/)
- [Flags](https://mdbootstrap.com/docs/standard/content-styles/flags/)
- [Hover effects](https://mdbootstrap.com/docs/standard/content-styles/hover-effects/)
- [Icons](https://mdbootstrap.com/docs/standard/content-styles/icons/)
- [Images](https://mdbootstrap.com/docs/standard/content-styles/images/)
- [Masks](https://mdbootstrap.com/docs/standard/content-styles/masks/)
- [Shadows](https://mdbootstrap.com/docs/standard/content-styles/shadows/)
- [Typography](https://mdbootstrap.com/docs/standard/content-styles/typography/)

-----

## Learn Bootstrap 5 in 1.5H

{% youtube c9B4TPnak1A %}

-----

## Additional resources

Learn web development with our **learning roadmap**:
**[:mortar_board: Start Learning](https://mdbootstrap.com/docs/standard/getting-started/)**

Join our mailing list & receive **exclusive resources** for developers
**[:gift: Get gifts](https://mdbootstrap.com/newsletter/)**

Join our private FB group for **inspiration & community experience**
**[👨‍👩‍👧‍👦 Ask to join](https://www.facebook.com/groups/682245759188413)**

**Support creation of open-source packages** with a STAR on GitHub
[![GitHub Stars](https://img.shields.io/github/stars/mdbootstrap/mdb-ui-kit?label=Star%20now&style=social)](https://github.com/mdbootstrap/mdb-ui-kit/)