Bootstrap 5 Modal Close on Back Button

A lightweight JavaScript utility that enhances Bootstrap 5 modals to close modals when browser back button is pressed.

It can be used in combination with: modal dynamic

Features

• Close a bootstrap modal with back button
• Preserves all native Bootstrap modal functionality
• No conflicts with existing modal implementations
• No jquery dependency
• No dependencies other than Bootstrap 5
• Lightweight (~1KB minified)
• No additional configuration needed - works out of the box!

Installation

Via CDN

<script src="https://cdn.jsdelivr.net/gh/FranBar1966/bootstrap-5-modal-close-on-back@0.0.1/src/modal-close-on-back.min.js"></script>

Download

Download the script from GitHub repository: close on back button and include in your HTML:

<script src="path/to/modal-close-on-back.min.js"></script>

Usage

Simply include the script after Bootstrap 5 - no additional configuration needed. You can add the script to your current html without making any changes at all.

See: DEMO

Modal example

<button type="button" class="btn btn-primary" data-bs-toggle="modal" data-bs-target="#modalExample" >
    Open modal
</button>

<div class="modal fade" id="modalExample" tabindex="-1" aria-labelledby="modalExampleLabel" aria-hidden="true">
    <div class="modal-dialog">
        <div class="modal-content">
            <div class="modal-header">
                <h1 class="modal-title fs-5" id="modalExampleLabel">Close modal on back button</h1>
                <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
            </div>
            <div class="modal-body">
                You can click the Back Button to close this modal.
            </div>
            <div class="modal-footer">
                <button type="button" class="btn btn-secondary" data-bs-dismiss="modal">Close</button>
            </div>
        </div>
    </div>
</div>

<script src="https://cdn.jsdelivr.net/gh/FranBar1966/bootstrap-5-modal-close-on-back@0.0.1/src/modal-close-on-back.min.js"></script>

How It Works

This is a lightweight JavaScript utility that enhances Bootstrap 5 modals by allowing them to close when the user clicks the browser's Back button .

Browsers do not automatically close modals when the back button is pressed. This utility adds that behavior to make your application more intuitive and consistent with user expectations. Especially if it is a PWA for mobile devices.

What it does

If the user clicks the close button in the modal, the browser goes back one step in the history using window.history.go(-1).

If the user presses the browser's back button (hashchange event), the utility detects this and closes the last open modal.

Contributing

We welcome contributions to this project. If you have suggestions for improvements or want to report issues, please create an issue or submit a pull request.

1. Fork the repository.
2. Create a new branch for your feature or bug fix.
3. Make your changes.
4. Submit a pull request.

License

The MIT License (MIT)

Copyright © 2025 github.com/FranBar1966

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.