Implement Custom useMediaQuery Hook in React
Explore code implementation of the custom useMediaQuery hook to handle the website responsiveness for different devices using common custom hook code
Anuj Sharma
Last Updated Jun 11, 2026

In frontend development, responsive design is crucial to ensure that websites adapt well to various screen sizes and devices. Media queries in CSS help achieve this responsiveness by applying different styles based on the device's characteristics.
However, handling this dynamically in React components can be challenging. To simplify this process, we can create a custom hook called useMediaQuery that allows us to conditionally render components based on the viewport size.
What do you need to know for implementation?
You should know the basic understanding of the implementation of custom hooks and the browser API window.matchMedia(<query>) that helps to determine if the document matches the media query string, as well as to monitor the document to detect when it matches that media query.
Code Implementation of useMediaQuery Custom Hook
Let's start by defining our custom hook useMediaQuery in React:
const useMediaQuery = (query) => {
const [matches, setMatches] = React.useState(false);
React.useEffect(() => {
const mediaQuery = window.matchMedia(query);
setMatches(mediaQuery.matches);
const handler = (event) => setMatches(event.matches);
mediaQuery.addEventListener('change', handler);
return () => {
mediaQuery.removeEventListener('change', handler);
};
}, [query]);
return matches;
};
Using the Custom Hook
Now, let's see how we can utilise our custom useMediaQuery hook in a React component:
const ResponsiveComponent = () => {
const isDesktop = useMediaQuery('(min-width: 1024px)');
return (
<div>
{isDesktop ? <h1>Welcome to Desktop View</h1> : <p>Welcome to Mobile View</p>}
</div>
);
};
Explanation
In the example above, we use useMediaQuery to check if the viewport width is at least 1024px, indicating a desktop view. Depending on the result, we render different content accordingly.
Now that you understand this custom hook, let's explore 20+ Most Asked Custom Hooks in React & 100+ top React Interview Questions and Answers to prepare for your next frontend interview
Happy Coding:)
A seasoned Sr. Engineering Manager at GoDaddy (Ex-Dell) with over 12+ years of experience in the frontend technologies. A frontend tech enthusiast passionate building SaaS application to solve problem. Know more about me 🚀
Learn Next
Featured
100+ Top React JS Interview Questions And Answers
Comments
Be the first to share your thoughts!
No comments yet.
Start the conversation!
Share your expertise
Publish a blog or quick notes on topics you know well — your write-up could be the answer someone needs before their next frontend interview.
Build your portfolio
Help the community
Sharpen your skills
Earn goodies
Other Related Blogs
React Hook Rules: Why hooks declarations are not allowed inside functions
Frontendgeek
Last Updated Feb 6, 2026
A quick guide to explain an important react interview question, why React Hooks declarations are not allowed inside functions or any conditional blocks with code example.
setTimeout Polyfill in JavaScript - Detailed Explanation
Anuj Sharma
Last Updated Aug 3, 2025
Explore the implementation of setTimeout in JavaScript with a detailed explanation for every step. Understand all scenarios expected to implement the setTimeout polyfill.
How does JWT (JSON Web Token) Authentication work - Pros & Cons
Frontendgeek
Last Updated Jun 9, 2026
Understand the JWT(JSON Web Token) and how JWT decode works. It also covers how the end-to-end JWT authentication works between client & server, along with the pros and cons of using JWT.
Implementing a stopwatch using React - Frontend Machine Coding Question
Pallavi Gupta
Last Updated Feb 21, 2026
Concise explanation of stopwatch implementation using React, it involves the usage of useEffect hook for creating a stopwatch and tracking milliseconds.
