CSS background-attachment
Published Jun 30, 2021Updated Oct 23, 2023
Contribute to Docs
Determines if the background image is fixed in relationship to the viewport or whether it will scroll along with the rest of the page.
Syntax
background-attachment: <value>;
Where <value> can be the following: scroll | fixed | local | initial | inherit
scrollis the default value. The background image will scroll with the page.fixedwill cause the background image to stay in the same position on the page.localwill result in the background image scrolling within the elements contents.
Example 1
Set background image to be fixed to the viewport:
body {height: 1200px;background-image: url('fish.png');background-repeat: no-repeat;background-size: 400px 100px;background-attachment: fixed;}
The following gif runs as a loop to demonstrate the code block above:

Example 2
Set background to scroll with the page:
body {height: 1200px;background-image: url('fish.png');background-repeat: no-repeat;background-size: 400px 100px;background-attachment: scroll;}
The following gif runs as a loop to demonstrate the code block above:

Contribute to Docs
- Learn more about how to get involved.
- Edit this page on GitHub to fix an error or make an improvement.
- Submit feedback to let us know how we can improve Docs.
Learn CSS on Codecademy
- Front-end engineers work closely with designers to make websites beautiful, functional, and fast.
- Includes 34 Courses
- With Professional Certification
- Beginner Friendly.115 hours
- A full-stack engineer can get a project done from start to finish, back-end to front-end.
- Includes 51 Courses
- With Professional Certification
- Beginner Friendly.150 hours