A Complete Guide - CSS Z Index and Stacking Context

Last Updated: 03 Jul, 2025

YOU NEED ANY HELP? THEN SELECT ANY TEXT.

CSS Z-Index and Stacking Context: Explained in Details with Important Information

What is a Z-Index?

The z-index property in CSS controls the vertical stacking order of positioned elements (elements with a position other than static). Positioned elements can be elements where the position property is set to absolute, relative, fixed, or sticky. When two or more positioned elements overlap, the element with the higher z-index will appear on top of the one with the lower z-index. Essentially, it’s a way to determine which elements should be placed above others in the third dimension—depth.

Example:

.element1 {
    position: absolute;
    z-index: 2; /* This element is stacked on top */
}

.element2 {
    position: absolute;
    z-index: 1; /* This element is stacked below */
}

Default Z-Index Behavior

By default, all non-positioned elements have a z-index value of auto, and their stacking order is determined by their appearance in the HTML document. Elements that come later in the document flow will naturally display over those appearing before them. When it comes to positioned elements, unless specified, they also have a z-index value of auto, but they are considered above all non-positioned elements.

Setting a Z-Index

To set the z-index of an element, you must also specify its positioning method. For example:

.stack-on-top {
    position: relative; /* or absolute, fixed, sticky */
    z-index: 5;
}

.stack-at-bottom {
    position: relative; /* or absolute, fixed, sticky */
    z-index: 3;
}

In the example above, .stack-on-top will appear above .stack-at-bottom.

Important Points About Z-Index

Z-Index only works for positioned elements: If an element is not positioned (no position attribute defined), setting a z-index has no effect.
Higher values go on top: An element with a higher z-index than another element will be displayed in front.
Negative Z-Indices: Elements can also have negative z-index values. A negative value places the element behind other elements with positive or higher negative values.
Z-Index and Non-Zero Opacity/Transforms: Applying opacity less than 1 or any transform (except translateZ(0)) to an element creates a new stacking context, affecting the way z-index is perceived within its parent.

Stacking Context

A stacking context is a three-dimensional conceptualization of HTML elements along an imaginary z-axis, which determines how elements layer on top of one another based on their z-index properties. Understanding stacking contexts is crucial for achieving precise layering and can help resolve unexpected stacking order issues.

Creating Stacking Contexts

Several factors can create a stacking context:

Root element (<html>) always forms the initial stacking context.
Positioning elements with z-index and a position value other than static.
Elements with opacity values less than 1.
Elements using certain CSS properties like transform, filter, isolation.
Flex items if the flex container has a z-index that establishes a stacking context.
Grid items if the grid container has a z-index that establishes a stacking context.
Absolutely positioned elements whose containing block has a z-index that establishes a stacking context.

Visualize Stacking Contexts

Stacking contexts can be nested within each other, with child stacking contexts being completely ordered independently of parent stacking contexts. To effectively manage layering, think of stacking contexts as layers within layers. Consider the following scenario:

<div class="outer">
    <div class="inner"></div>
</div>

.outer {
    position: relative;
    z-index: 10;
    background-color: red;
}

.inner {
    position: relative;
    z-index: 15;
    background-color: blue;
}

Here, the .inner div is a stacking context within the .outer div. Within the .outer stacking context, .inner appears above the parent due to its higher z-index value. However, this doesn't necessarily mean .inner will appear above all other elements on the page because it's a separate stacking context.

Controlling Content Visibility

With an understanding of stacking contexts, you can better leverage z-index to control what content is visible or hidden. This can be useful in various design patterns such as tooltips, dropdown menus, and modal dialogs, where certain content needs to overlay other parts of the webpage.

Practical Use Cases

Dropdown Menus: By default, dropdown menu items might get cut off if they extend beyond a container. Applying a higher z-index ensures they display above other content.
Modals: Modal dialogue boxes often need to sit on top of all other website content. This is achieved by creating stacking contexts with high z-indexes.
Carousels: Slides in a carousel can be dynamically changed using z-index to bring the active slide to the forefront.

Troubleshooting Common Issues

Understanding stacking contexts can help tackle common issues such as why some elements aren’t displaying as expected when using z-index. Here are a few steps:

Check the positioning: Ensure that the elements involved have a non-static position (relative, absolute, fixed, etc.).
Inspect stacking contexts: Use browser developer tools to inspect the DOM hierarchy and identify stacking contexts.
Adjust Z-Scale: If necessary, adjust the stacking order by tweaking the z-index values or restructuring your HTML to ensure the desired stacking context behavior.

Conclusion

Mastering CSS z-index and stacking contexts is key to managing complex layered designs effectively. It provides a framework to control the depth and visibility of elements, improving the interactivity and aesthetic of web layouts. By applying the principles outlined here, developers can achieve the desired visual layering while maintaining structured and maintainable code.

Online Code run

🔔 Note: Select your programming language to check or run code at

💻 Run Code Compiler

Step-by-Step Guide: How to Implement CSS Z Index and Stacking Context

Step 1: Understanding z-index

The z-index property in CSS controls the stack order of elements that overlap. This property only works on positioned elements (i.e., elements with position set to relative, absolute, fixed, or sticky). Elements with higher z-index values are placed in front of elements with lower z-index values.

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Z-Index Example</title>
    <style>
        #box1 {
            position: absolute;
            width: 100px;
            height: 100px;
            background-color: red;
            top: 50px;
            left: 50px;
            z-index: 1; /* Lower z-index */
        }

        #box2 {
            position: absolute;
            width: 100px;
            height: 100px;
            background-color: blue;
            top: 100px;
            left: 100px;
            z-index: 2; /* Higher z-index */
        }
    </style>
</head>
<body>
    <div id="box1"></div>
    <div id="box2"></div>
</body>
</html>

In this example:

Two div boxes (#box1 and #box2) are positioned absolutely.
#box1 is placed behind #box2 because its z-index value (1) is lower than that of #box2 (2).

Step 2: Introducing Stacking Context and Positioning

A stacking context is a three-dimensional conceptualization of HTML elements along an imaginary z-axis, which determines how they overlap each other. Elements within the same stacking context can be stacked on top of each other using z-index. However, an element in a different stacking context will always appear above or below all elements in other stacking contexts.

Creating stacking context with position and z-index:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Stacking Context Example</title>
    <style>
        #container1 {
            position: relative;
            width: 200px;
            height: 200px;
            background-color: lightblue;
            left: 50px;
            top: 50px;
            z-index: 1;
        }

        #container2 {
            position: relative;
            width: 200px;
            height: 200px;
            background-color: yellow;
            left: 100px;
            top: 100px;
            z-index: 3;
        }

        #box1 {
            position: absolute;
            width: 100px;
            height: 100px;
            background-color: red;
            top: 50px;
            left: 50px;
            z-index: 2; /* Inside container1 stacking context */
        }

        #box2 {
            position: absolute;
            width: 100px;
            height: 100px;
            background-color: blue;
            top: 100px;
            left: 100px;
            z-index: 4; /* Inside container2 stacking context */
        }
    </style>
</head>
<body>
    <div id="container1">
        <div id="box1"></div>
    </div>
    <div id="container2">
        <div id="box2"></div>
    </div>
</body>
</html>

In this example:

#container1 and #container2 create stacking contexts due to their position: relative and z-index properties.
#box1 is positioned absolutely inside #container1 and has a z-index of 2.
#box2 is positioned absolutely inside #container2 and has a z-index of 4.
Despite #box1 having a z-index of 2, it is rendered beneath #box2 because #container2 (with a z-index of 3) creates a higher stacking context than #container1.

Step 3: Creating Stacking Contexts with CSS Properties

Apart from position and z-index, several other CSS properties can create stacking contexts:

opacity less than 1
transform other than none
filter other than none
isolation: isolate
-webkit-overflow-scrolling: touch
mix-blend-mode other than normal
background-color or background-image with blending mode other than normal
position: fixed

Example Using `opacity`:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Opacity Stacking Context Example</title>
    <style>
        #container1 {
            position: relative;
            width: 300px;
            height: 300px;
            background-color: lightgreen;
            left: 50px;
            top: 50px;
            opacity: 0.9; /* Creates stacking context */
            z-index: 1;
        }

        #box1 {
            position: absolute;
            width: 150px;
            height: 150px;
            background-color: purple;
            top: 100px;
            left: 100px;
            z-index: 2;
        }

        #box2 {
            position: absolute;
            width: 150px;
            height: 150px;
            background-color: green;
            top: 70px;
            left: 70px;
            z-index: 0;
        }
    </style>
</head>
<body>
    <div id="container1">
        <div id="box1"></div>
        <div id="box2"></div>
    </div>
</body>
</html>

In this example:

#container1 creates a stacking context because of its opacity property set to 0.9.
#box1 and #box2 are positioned absolutely inside #container1.
Even though #box2 has a higher z-index (2), #box1 appears above it because both boxes are already inside #container1’s stacking context, which is created by opacity.

Step 4: Advanced Example with Nested Stacking Context

This final example demonstrates nested stacking contexts and how z-index interacts within different contexts.

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Nested Stacking Context Example</title>
    <style>
        body {
            position: relative;
            height: 100vh;
        }

        #outerContainer {
            position: relative;
            width: 300px;
            height: 300px;
            margin: 50px auto;
            border: 2px solid black;
            background-color: lightcoral;
        }

        #container1 {
            position: relative;
            width: 200px;
            height: 200px;
            background-color: lightyellow;
            margin: 30px;
            z-index: 1;
        }

        #container2 {
            position: absolute;
            width: 200px;
            height: 200px;
            background-color: lavender;
            left: 50px;
            top: -50px;
            z-index: 3;
            opacity: 0.9; /* Creates stacking context */
        }

        #boxInContainer1 {
            position: absolute;
            width: 100px;
            height: 100px;
            background-color: orange;
            top: 50px;
            left: 50px;
            z-index: 5;
        }

        #boxInContainer2 {
            position: absolute;
            width: 100px;
            height: 100px;
            background-color: pink;
            top: 60px;
            left: 60px;
            z-index: 4; /* Inside container2's stacking context */
        }
    </style>
</head>
<body>
    <div id="outerContainer">
        <div id="container1">
            <div id="boxInContainer1"></div>
        </div>
        <div id="container2">
            <div id="boxInContainer2"></div>
        </div>
    </div>
</body>
</html>

In this example:

#container1 and #container2 are positioned relative and have different z-indexes, but #container2 also has an opacity which creates independent stacking contexts.
#boxInContainer1 and #boxInContainer2 are absolutely positioned inside their respective containers.
#boxInContainer1 would naturally appear above #boxInContainer2 based on z-index alone, but since #container2 creates a new stacking context, #boxInContainer2 with z-index: 4 appears above #boxInContainer1 with z-index: 5.
To ensure #boxInContainer1 is above everything, including within #container2, you can give #container1 a high z-index, but remember that #container2 still creates a higher stacking context due to opacity.

Summary

z-index: Controls the stack order of elements within the same stacking context.
Stacking Context: A 3D conceptualization of HTML elements determined by certain CSS properties. It decides which elements overlap others.
Creating Stacking Context: Properties like position (with z-index other than auto), opacity, transform, filter, isolation, and more.
Positioning: position relative, absolute, fixed, etc., is crucial for z-index and stacking context interactions.

A Complete Guide - CSS Z Index and Stacking Context

CSS Z-Index and Stacking Context: Explained in Details with Important Information

What is a Z-Index?

Default Z-Index Behavior

Setting a Z-Index

Important Points About Z-Index

Stacking Context

Creating Stacking Contexts

Visualize Stacking Contexts

Controlling Content Visibility

Practical Use Cases

Troubleshooting Common Issues

Conclusion

Online Code run

Step 1: Understanding z-index

Step 2: Introducing Stacking Context and Positioning

Step 3: Creating Stacking Contexts with CSS Properties

Example Using opacity:

Step 4: Advanced Example with Nested Stacking Context

Summary

You May Like This Related .NET Topic

Example Using `opacity`: