Why is my Bootstrap modal not working?
- Ensure jQuery and Popper.js are included in the correct order before Bootstrap JS. 2. Verify modal HTML structure with proper data-bs-* attributes and matching IDs. 3. Check browser console for JavaScript errors and ensure DOM is ready. 4. Confirm CSS is loaded and no custom styles block visibility. Most issues stem from missing dependencies, incorrect markup, or script conflicts.

If your Bootstrap modal isn't working, it's usually due to missing dependencies, incorrect markup, or JavaScript issues. Here’s how to troubleshoot and fix the most common problems.
Check Required Dependencies
Bootstrap modals need jQuery and Popper.js (for Bootstrap 4 ) to function properly. Make sure you’ve included them in the correct order:
- Popper.js (required for Bootstrap 4 and 5 if using dropdowns or tooltips in the modal)
- jQuery (required before Bootstrap JS)
- Bootstrap’s JavaScript file
Example for Bootstrap 5:
Verify HTML Structure
Your modal markup must follow Bootstrap’s required structure. A minimal working example:
Make sure:
- The button has data-bs-toggle="modal" and data-bs-target="#myModal" (Bootstrap 5 syntax)
- The modal has id="myModal" matching the target
- You’re using the right attribute syntax: data-bs-* not data- alone
JavaScript Conflicts or Errors
Open the browser console (F12) and check for errors like:
- "$ is not defined" → jQuery not loaded
- "bootstrap is not a function" → Bootstrap JS not loaded or wrong version
If you're initializing the modal with JavaScript, ensure the DOM is ready:
document.addEventListener("DOMContentLoaded", function () {var myModal = new bootstrap.Modal(document.getElementById('myModal'));
// myModal.show(); // if triggering manually
});
CSS or Display Issues
Sometimes the modal appears but isn’t visible. Check:
- Is the backdrop showing but content missing? Likely a structural issue.
- Are styles loading? Confirm bootstrap.min.css is included.
- Any custom CSS hiding the modal (e.g., display: none !important)?
Basically, double-check your script order, use correct data attributes, and validate the HTML structure. Most modal issues are resolved by fixing one of these areas.
The above is the detailed content of Why is my Bootstrap modal not working?. For more information, please follow other related articles on the PHP Chinese website!
Hot AI Tools
Undress AI Tool
Undress images for free
AI Clothes Remover
Online AI tool for removing clothes from photos.
Undresser.AI Undress
AI-powered app for creating realistic nude photos
ArtGPT
AI image generator for creative art from text prompts.
Stock Market GPT
AI powered investment research for smarter decisions
Hot Article
Popular tool
Notepad++7.3.1
Easy-to-use and free code editor
SublimeText3 Chinese version
Chinese version, very easy to use
Zend Studio 13.0.1
Powerful PHP integrated development environment
Dreamweaver CS6
Visual web development tools
SublimeText3 Mac version
God-level code editing software (SublimeText3)
Hot Topics
20521
7
13634
4
How to ensure your Bootstrap site is fully accessible (WCAG)? (Accessibility)
Mar 08, 2026 am 01:25 AM
The Bootstrap component does not automatically add the aria attributes required for complete WCAG. You need to manually complete aria-expanded, role="dialog", aria-labelledby, etc.; the form must be equipped with an explicit label; :focus needs to use :focus-visible to ensure that the keyboard focus is visible; the color contrast must reach 4.5:1.
How to animate Bootstrap components for a more dynamic feel? (Advanced CSS)
Mar 13, 2026 am 01:13 AM
The fade and show classes of Bootstrap5 are only status markers and do not contain animation logic. You need to manually add @keyframes or transitions to achieve fade-in and fade-out; custom components need to configure additional animation rules, and when JS controls the display, the show class must be added with delay to ensure redrawing.
How to create a professional-looking landing page with Bootstrap? (Project-Based)
Mar 10, 2026 am 12:22 AM
Bootstrap’sdefaultstylingfeelsgenericduetouncustomizedspacing,typography,andcolor—fixableviaCSSvariablesorSass,notdirectedits;avoidfixedwidths,misuseofgridclasses,andrender-blockingassetstoensureresponsivenessandfastLCP.
How to integrate Bootstrap with a JavaScript framework like React or Vue? (Integration)
Mar 12, 2026 am 01:22 AM
Only BootstrapCSS should be introduced in React/Vue instead of JS to avoid global style pollution and jQuery dependency; SCSS modules should be imported on demand to reduce the size; interactive functions must be imported with encapsulation libraries (such as react-bootstrap) or ESM; grid classes need to adapt to JSX/Vue syntax, and explicit and implicit classes should be used with SSR with caution.
How to implement a carousel or image slider with Bootstrap? (Content Display)
Mar 07, 2026 am 01:01 AM
Need not. Bootstrap5's carousel is automatically initialized by default. You need to manually call newbootstrap.Carousel() only when data-bs-ride is modified or the element is dynamically inserted.
How to use Bootstrap utility classes to speed up your workflow? (Efficiency)
Mar 11, 2026 am 12:18 AM
Use mt-3 to represent the top margin, mb-3 to represent the bottom margin, and the suffixes t/b/s/e correspond to top/bottom/start/end respectively; ms-auto implements right alignment in the flex container, me-2 replaces the abandoned mr-2, and responsive classes such as mt-md-4 need to have breakpoint prefixes.
How to properly install and set up Bootstrap 5 in your web project? (Getting Started)
Mar 16, 2026 am 12:40 AM
To correctly introduce Bootstrap5, you need to load bootstrap.min.css first, then load bootstrap.bundle.min.js (including Popper), and ensure that the viewport tag exists; after npm installation, you need to manually introduce compiled files in the dist directory. SCSS customization must be preceded by variable declarations, and JS components must be explicitly initialized to avoid jQuery contamination.
How to create a responsive sidebar navigation with Bootstrap? (UI Patterns)
Mar 16, 2026 am 12:37 AM
The only sidebar solution natively supported by Bootstrap 5 is offcanvas. It defaults to a drawer for small screens and can be resident for large screens. It has backdrop, keyboard close, animation and accessibility support. It needs to use dual structure or JS to dynamically control the responsive display, and customize the width, height and background through CSS variables.





