If your MacBook is having major hardware problems, the Apple Diagnostics menu can help make sense of what’s wrong.
A MacBook that keeps shutting down, develops display problems or suddenly stops recognizing its keyboard can leave you guessing whether the problem is hardware or software. Apple Diagnostics can narrow that down by testing hardware inside the Mac. Despite the “diagnostic menu” wording you may see online, it isn’t something you’ll find buried in System Settings. You access it while your Mac starts up.
Before you get there, you need to know which type of MacBook you have, since the startup process differs between them. Open the Apple menu and select
followed by the name of an M-series processor, you have an Apple silicon Mac. An older model may instead show
The experience inside Apple Diagnostics depends on your version of macOS, too. Macs running macOS 26 Tahoe or later can offer individual diagnostics for hardware such as the built-in display, keyboard or trackpad. On earlier versions, the diagnostic test runs automatically.
installing available macOS updates if your MacBook is usable enough to do so. Once that’s done, shut down the machine and disconnect external devices. Leave only necessary connections such as power and Ethernet, as well as an external keyboard, mouse or display if applicable. Put your MacBook on a hard, flat surface with good ventilation.
, press and hold the power button (the Touch ID button also serves as the power button on MacBooks equipped with it). Keep holding until the startup options screen appears and you see
, turn the computer on and immediately press and hold
. Release the key when you see a progress bar or are asked to select a language. If that shortcut doesn’t work, restart and try holding both
, which can start Apple Diagnostics over the internet.
opens. Your MacBook may ask to connect to Wi-Fi if it’s not wired in. On macOS 26 Tahoe or later, you’ll also see the available diagnostic choices and can select the test that matches the problem you’re investigating. Earlier versions generally begin testing automatically.
Apple Support or a repair technician can also start an online Apple Diagnostics session in some cases. Unless you’re running this at their request, choose
Apple Diagnostics is a hardware troubleshooting tool. It can identify potential faults involving internal components, showing specific codes for areas like memory, batteries, cameras, keyboards, trackpads, storage, displays and wireless hardware.
What it can’t do is just as useful to understand. It doesn’t test external hardware such as a connected USB accessory, and it isn’t designed to find problems caused by macOS, apps or software extensions. If a certain app keeps crashing or an external drive repeatedly disconnects, for example, Apple Diagnostics probably won’t have anything useful to report. Apple’s
This also changes how you should interpret a clean test. The reference code
means Apple Diagnostics found no issues. It doesn’t prove nothing is wrong with your MacBook; it means the test didn’t identify a problem with the hardware it checked. This leaves software, an external accessory or another cause still on the table.
When Diagnostics returns a component-specific code, you can look it up to see what part of the MacBook it relates to. This will show whether Apple recommends additional troubleshooting or service.
If Apple Diagnostics returns one or more reference codes, keep them.
explains what they mean and, where applicable, what to do next. The codes are also useful if you contact Apple Support or take your MacBook to an Apple Store, Apple Authorized Service Provider or Independent Repair Provider.
If Diagnostics doesn’t identify a hardware problem, but your MacBook is still misbehaving, the next step depends on the symptoms. One option is
, sometimes informally described as a Mac’s “repair mode.” Recovery is different from Apple Diagnostics: it provides tools for repairing the startup disk with Disk Utility, reinstalling macOS, or restoring from a Time Machine backup.
on an Apple silicon MacBook, shut it down and hold the power button until startup options appear. Select
. On an Intel MacBook, turn it on and immediately hold
until you see the Apple logo or a spinning globe. Be aware that
That difference can save you from troubleshooting the wrong issue. Apple Diagnostics is the place to start when you suspect an internal hardware failure. If the hardware test comes back clean, software troubleshooting or macOS Recovery may be the more useful next move. For minor issues,