Model-specific diagnostic path

MacBook Air M5 USB-C / Thunderbolt dock not working

The Mac exposes Thunderbolt 4/USB4, charging and DisplayPort on its USB-C ports, but each dock function can fail independently. Test power, display and USB data as separate paths.

QUESTIONWhy isn't my USB-C dock working on MacBook Air M5?

Start with evidence

Run the tests that separate the likely branches

Decision table

What the observation changes

ObservationWhat it meansNext action
Mac charges but USB/display failPower delivery works; it does not prove USB4 or DisplayPort lanes.Swap to the dock's certified full-featured upstream cable.
USB devices work but display failsBasic USB data works; focus on video capability/topology.Test display direct to Mac, then verify dock display spec.
Dock works on one Mac port onlyPort/cable/physical state needs isolation.Repeat with same cable and inspect system/native diagnostics.

Sequence

Work from reversible checks to escalation

  1. 01

    Use the dock's intended upstream cable.

  2. 02

    Test dock on both Mac ports.

  3. 03

    Separate charging, USB data and display observations.

  4. 04

    Test key peripherals directly to Mac.

Likely areas

Keep these branches separate

Dock power deliveryCable not full-featuredDisplay pathUSB device/driverDock firmware

Repair boundary

When to stop changing settings

If both Thunderbolt ports fail with multiple known-good USB-C/Thunderbolt devices, run Apple Diagnostics/service path.