If your MacBook is shutting down at random, making odd noises, or has a keyboard, trackpad, or Wi-Fi connection that keeps acting up, you’re probably wondering whether something inside has failed. Apple Diagnostics is a free hardware check built into every Mac. This guide shows you how to run Apple Diagnostics on a MacBook, on both Apple silicon and Intel models, and how to read the short reference code you get at the end.
The short answer: On an Apple silicon Mac, shut down, then press and hold the power button (Touch ID) until you see Options. Release it, then press and hold Command (⌘)-D. On an Intel Mac, turn it on and immediately hold D. If that doesn’t work, try Option (⌥)-D. When the test finishes, write down the reference code and look it up on Apple’s official reference-code page.
A result of ADP000 means no issues were found. For any other code, Apple’s reference-code page explains what it means and whether service is suggested. Many non-ADP000 codes are worth discussing with a repair provider, though not every code necessarily means immediate repair is required.
What Is Apple Diagnostics?
Apple Diagnostics tests your Mac’s internal hardware, which can include components such as the logic board (the Mac’s main circuit board), memory, and wireless hardware. Apple describes the tool as helping to identify a faulty hardware component, though the exact components checked can vary by Mac model.
It runs before macOS loads, so there’s nothing to download or install. You start it with a key combination at startup (Apple Support).
What it doesn’t test is just as important. It doesn’t check macOS itself, your apps, system extensions, or external accessories. Keep that in mind when you read your results.
You may also come across Apple Diagnostics for Self Service Repair. This is a different tool altogether: a browser-based diagnostic console used as part of Apple’s Self Service Repair program, not the Command-D test covered in this guide.
According to Apple’s Self Service Repair documentation, it requires a Mac with Apple silicon running macOS Sonoma 14.1 or later, a second internet-connected device, and enrollment of your Mac’s serial number, and it doesn’t support Intel Macs. This guide covers the everyday consumer test, which works differently and needs none of that setup.
Before You Begin
Work through this checklist before you start:
- Know your chip type. Choose Apple menu () > About This Mac. A line labeled Chip (for example, “Apple M2”) means you have Apple silicon. A line labeled Processor that names an Intel CPU means you have an Intel Mac.
- Update macOS if your Mac still starts normally. Go to System Settings > General > Software Update and install any available updates.
- Back up your data if you suspect a hardware fault. Time Machine to an external SSD is the easiest way.
- Have a way to get online. Use Wi-Fi or Ethernet. Some steps and service options need a connection.
- Find a hard, flat, stable surface with good airflow. Apple recommends this before you test.
- Keep paper or your phone nearby to write down the reference code.
| Requirement | Details |
|---|---|
| Device | Any Mac with Apple silicon or an Intel processor |
| OS version | Any; in macOS Tahoe 26 and later you choose which test to run, while earlier versions run automatically |
| Cost | Free, built into your Mac |
| Accessories | Only the keyboard, mouse or trackpad, display, Ethernet (if used), and power should be connected |
| Internet | Wi-Fi or Ethernet, needed if prompted and for Option-D on Intel |
Step-by-Step Guide: How to Run Apple Diagnostics on a MacBook
Step 1: Shut Down Your Mac
Choose Apple menu () > Shut Down and wait for the screen to go fully black.
If your Mac is frozen and won’t shut down, press and hold the power button for up to 10 seconds until it turns off.
Expected result: The Mac is completely off. The screen is dark and the keyboard backlight is off.
Step 2: Disconnect Extra Accessories
Unplug everything except these:
- Keyboard
- Mouse or trackpad
- Display
- Ethernet cable (if you use one)
- Power adapter
That includes external drives, printers, card readers, and any USB-C hub or dock. Apple asks you to disconnect them before testing, which keeps the run focused on your Mac’s internal hardware.
Tip: If your Wi-Fi is unreliable, a USB-C to Ethernet adapter gives the test a steady wired connection. That’s fine to leave plugged in, since Ethernet is on Apple’s allowed list.
Expected result: Only the essential connections are still attached.
Step 3 (Apple Silicon Macs): Open Startup Options and Press Command-D
Use this step if About This Mac showed a Chip line.
- Press and hold the power button. On a MacBook Air or MacBook Pro, that’s the Touch ID button.
- Keep holding while the Mac turns on and loads startup options.
- When you see Options on screen, release the power button.
- Press and hold
Command (⌘)-Duntil the Mac restarts into Apple Diagnostics.
Expected result: The Mac restarts and Apple Diagnostics loads. You may first be asked to choose a language.
Warning: Timing is the most common stumbling block.
Command-Donly works after Options appears. If you press it while you’re still holding the power button, nothing happens.
Step 3 (Intel Macs): Hold D at Startup
Use this step if About This Mac showed a Processor line with an Intel CPU.
- Turn on your Mac.
- Immediately press and hold the
Dkey. - Release the key when you see a progress bar or a prompt to choose a language.
If holding D doesn’t work, shut down and try again with Option (⌥)-D. This version runs Apple Diagnostics over the internet, so make sure your Mac can reach Wi-Fi or Ethernet.
Expected result: A language prompt or a progress bar appears instead of the normal login screen.
Step 4: Connect to the Internet If Asked
If Apple Diagnostics asks for a network connection, click the Wi-Fi menu in the upper-right corner of the screen and choose your network. You can also plug in an Ethernet cable.
Expected result: The Wi-Fi icon shows you’re connected and the test continues.
Step 5: Choose Run Offline, If You See It
Some Macs and macOS versions show a terms-and-conditions screen with a Run Offline option. If you see it, choose Run Offline unless Apple Support or a technician has already started an online diagnostic session for your Mac.
If this screen doesn’t appear, your Mac simply continues to the test.
Expected result: The test begins without sending anything to Apple.
Step 6: Pick a Test, If Prompted
In macOS Tahoe 26 and later, Apple Diagnostics asks you to choose a specific test instead of running everything automatically, such as:
- Built-in display
- Keyboard
- Trackpad
If you’re asked to choose, pick the test that matches your symptom. For example, choose Keyboard if a key is unresponsive.
In earlier versions of macOS, there’s nothing to choose. The checks run automatically, and this step doesn’t apply.
Expected result: The test you chose (or the full check) starts and a progress screen appears.
Step 7: Wait for the Test to Finish
A progress indicator shows while Apple Diagnostics works. Leave the Mac alone, keep it plugged in, and don’t close the lid.
Expected result: The progress screen gives way to a results screen.
Step 8: Write Down Your Reference Code
When testing is done, Apple Diagnostics shows one or more reference codes. These are short letter-and-number codes, such as ADP000. Write down each code exactly as it appears.
A quick note like this one will save you a step later:
Date tested: 2026-10-27
Mac model: (from About This Mac)
Chip type: Apple silicon / Intel
macOS version:
Test run: (if prompted: display / keyboard / trackpad / other)
Reference code(s):
Symptom that prompted the test:
The results screen also gives you options, such as running the test again, restarting, or shutting down. Follow the on-screen labels to pick one. They can vary by Mac and macOS version.
Expected result: You have the exact code or codes written down.
How to Interpret Apple Diagnostics Results
Look Up Your Code on Apple’s Official Table
Don’t guess what a code means, and don’t rely on forum posts. Apple keeps an official Apple Diagnostics reference codes page. It lists the current codes, what each refers to, and what Apple suggests you do next.
Here’s how to use it:
- Open support.apple.com/en-us/102334 on any device.
- Press
Command-Fon a Mac, or use Find on Page on an iPhone, and search for your exact code. - Read Apple’s description and suggested next step in that row.
Codes are grouped by the letters at the start, and each group relates to a particular area of hardware. Apple’s table includes codes for wireless hardware like Wi-Fi, for Ethernet, for sensors such as the ambient light sensor (the sensor that adjusts screen brightness), and for other components. Since Apple updates this table, always check the live page for the current wording rather than relying on a saved copy.
What ADP000 (“No Issues Found”) Does and Doesn’t Prove
ADP000 means Apple Diagnostics found no issues. That’s genuinely good news, but here’s what it actually tells you:
- It does mean the internal hardware that was tested passed during this run.
- It doesn’t mean macOS, your apps, or system extensions are problem-free. Apple Diagnostics doesn’t test software at all.
- It doesn’t cover external accessories like drives, hubs, or third-party devices.
- It might miss problems that come and go. If your issue is intermittent, it may not have happened while the test was running.
- If you ran a specific test, the result only covers that test. A clean keyboard test says nothing about the display.
So treat ADP000 as “the hardware looks fine right now.” Then turn your attention to software and accessories. If the problem keeps coming back, run the test again right after it happens.
When a Code Justifies a Repair Visit
If you get any code other than ADP000, Apple Diagnostics has flagged something specific. Apple’s reference-code page explains what that particular code means and whether it points to a hardware issue needing service.
In many cases, it’s best to stop troubleshooting on your own and get a professional opinion, though the right next step depends on what that specific code says. You can go to:
- Apple (an Apple Store or Apple Support)
- An Apple Authorized Service Provider (AASP)
- An Independent Repair Provider
Bring these with you:
- The exact reference code(s) from your note
- Your Mac model and macOS version
- A short description of the symptom and when it happens
- A recent backup, ideally on an external SSD or another Time Machine drive
The code gives the technician a documented starting point, so you don’t have to rely on describing the problem from memory. Apple Diagnostics is a first check, not a replacement for professional repair. A technician may run deeper tests of their own. Ask the provider directly about cost and coverage for your specific Mac.
Torn between fixing an older MacBook and upgrading? Our Mac Repair vs Replace guide walks through that decision.
Configuration: Common Settings and Choices
| Setting | Default | What to Choose |
|---|---|---|
| Run Offline vs online | Run Offline, if offered | If you see a Run Offline option, choose it unless a technician has started an online session for your Mac |
| Test selection (if prompted) | Asked in macOS Tahoe 26 and later | Pick the test that matches your symptom (display, keyboard, trackpad, and so on) |
| Test selection (if not prompted) | Checks run automatically in earlier macOS versions | Nothing to choose |
| Network connection | Not connected until prompted | Use the Wi-Fi menu (upper right) or plug in Ethernet |
| Intel startup key | D | Use Option-D (internet version) if D doesn’t work |
A useful pattern: if Apple Diagnostics asks you to pick a test and you have one specific symptom, start with the matching test. If you have several unrelated symptoms, run each relevant test one at a time and write down a code for each.
Tips and Troubleshooting
Command-D Does Nothing on an Apple Silicon Mac
Why it happens: You pressed Command-D too early, before Options appeared.
Fix: Shut down and start over. Hold the power button (Touch ID) until Options appears, release it, then press and hold Command-D until the Mac restarts.
Holding D Does Nothing on an Intel Mac
Why it happens: Some Intel Macs or keyboard setups don’t respond to D alone at startup.
Fix: Shut down and try Option (⌥)-D instead, with a network connection available. If neither works, check Apple’s Mac User Guide on diagnosing problems for more help.
Diagnostics Can’t Reach the Internet
Why it happens: Your Mac isn’t connected to Wi-Fi or Ethernet, which some steps and the online support options require.
Fix: Choose a network from the Wi-Fi menu in the upper-right corner, or plug in Ethernet, then continue. If Wi-Fi is the reason you’re testing in the first place, our Mac WiFi Not Working guide covers the software side in detail.
A Code Seems to Point to an External Device
Why it happens: An external device was still connected during the test. Apple’s reference-code table includes some codes for external-device findings, so check your code there too.
Fix: Disconnect everything except the keyboard, mouse, display, Ethernet (if used), and power. Then run the test again. If a code still appears, look it up on Apple’s reference-code page.
“No Issues Found,” but the Mac Still Misbehaves
Why it happens: Apple Diagnostics only checks internal hardware, and it might not catch problems that come and go.
Fix: Look into software next: updates, recently installed apps, and extensions. Also test your accessories one at a time. If the symptom is intermittent, run Apple Diagnostics again soon after it happens. For a stubborn keyboard, see our MacBook Keyboard Not Working guide.
The Mac Won’t Shut Down to Start the Test
Why it happens: A frozen app or system state is blocking a normal shutdown.
Fix: Press and hold the power button for up to 10 seconds until the Mac turns off. Then follow the Apple silicon or Intel steps above.
A Hardware Code Appeared and You’re Not Sure What to Do
Why it happens: The code identifies an area of hardware, but the screen alone may not explain how serious the problem is.
Fix: Look up the exact code on Apple’s official page. Then take that code to Apple, an AASP, or an Independent Repair Provider. Don’t try to diagnose it further yourself.
Quick tips:
- Snap a photo of the results screen with your phone. It’s faster than writing the code down and avoids typos.
- Keep the power adapter connected for the whole test.
- Retest after a fix. Running Apple Diagnostics again after a repair confirms whether the code is gone.
Wrapping Up
You now know how to start Apple Diagnostics on either kind of MacBook and how to turn the cryptic code into a clear next step. The test has limits: it ignores software and might not catch problems that come and go. It’s also free, it takes only a few minutes, and a specific code gives you real evidence to bring to a repair appointment. Honestly, that’s worth doing before you spend money on anything.
| Step | Action | Applies To |
|---|---|---|
| 1 | Shut down (hold power up to 10 seconds if frozen) | All Macs |
| 2 | Disconnect all but keyboard, mouse, display, Ethernet, power | All Macs |
| 3 | Hold power until Options, release, hold Command-D | Apple silicon |
| 3 | Hold D at startup (or Option-D) | Intel |
| 4–5 | Connect to the internet if asked; choose Run Offline, if offered | All Macs |
| 6 | Choose a specific test, if prompted | macOS Tahoe 26 and later |
| 7–8 | Wait, then write down the exact reference code | All Macs |
| Look up the code; if it isn’t ADP000, Apple’s page explains the suggested next step | All Macs |
Resources
- Apple Support: Use Apple Diagnostics to test your Mac
- Apple Support: Apple Diagnostics reference codes
- Apple Support: Apple Diagnostics for Self Service Repair
- Mac User Guide: Diagnose problems
Sources retrieved October 27, 2026.