Magento 2 modal z-index

Magento 2 modal z-index

August 24, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento 2 modal z-index

Solving Magento 2 Modal Z-Index Issues

In this post, we’ll explore how to modify the z-index of Magento 2’s built-in modal widget. Z-index determines the order in which elements overlap, making it crucial for ensuring your modals appear correctly above other content.

UnderstandingMagento 2’s Built-In Modal Widget

Magento 2 includes a modal.js file that handles its default modal functionality. This file uses jQuery to create and manage modal windows throughout the application. By default, all Magento 2 modals share the same z-index value.

However, there are cases where you might need to adjust these values, for example, when multiple modals overlap incorrectly or when a specific modal needs priority over others.

The Problem with Changing Z-Index

You may have noticed that the zIndex option in Magento 2’s modal options doesn’t seem to work as expected:

var options = {
  type: 'popup',
  clickableOverlay: true,
  zIndex: 9995 // This value is ignored
};

var modalPopup = modal(options, $('#modal_id'));

The issue lies in how Magento 2 manages the modal’s CSS. The actual z-index is set via stylesheets, and this value takes precedence over any JavaScript options you might specify.

A Workaround Solution

To override the z-index, we’ll need to directly modify the CSS of the relevant elements. Here’s a step-by-step guide:

  1. Find the modal overlay element: Look for the class responsible for the modal overlay in the Magento_Theme module’s css directory. The default class is .modal-overlay.

  2. Create a custom stylesheet: Copy this file to your custom theme or create a new one, and apply a higher z-index value:

    .modal-overlay {
      position: fixed;
      z-index: 9995; /* Adjust as needed */
    }
    
  3. Include your custom stylesheet: In your app/design/frontend/<vendor>/<theme>/Magento_Theme/requirejs-config.js file, add a new require config to include your custom stylesheet:

    var config = {
      map: {
        '*': {
          'mage/modal': 'Vendor_Module/js/modal'
        }
      },
      shim: {
        'Vendor_Module/js/modal': {
          deps: ['jquery']
        }
      }
    };
    

Replace Vendor_Module with the appropriate details for your custom module.

  1. Refresh and test: Clear your cache, refresh the page, and check if your modal appears at the desired z-index level.

Conclusion

Modifying Magento 2’s built-in modal widget z-index isn’t straightforward due to how the z-index is managed via CSS. However, by directly modifying the relevant stylesheets in your custom theme, you can achieve the desired results.

Remember, changing z-index values should be done judiciously to avoid overlapping issues and ensure a consistent user experience across your store.

If you’re looking for more advanced customization options or want to explore other areas of Magento development, feel free to browse our Magento 2 resources at Laravel Company. We provide comprehensive guides and tutorials on everything from theme development to extension creation.

Magento 2 Indexing Database Extensions

Our network