Installing and Fixing Seeed XIAO Library in KiCad

Fab Academy 2026 – Electronics Design

1. Objective

Install and correctly configure the Seeed Studio XIAO Series library in KiCad, including:
• Symbols (.kicad_sym)
• Footprints (.kicad_mod → .pretty structure)
• Proper symbol ↔ footprint linking
• Eliminating “footprint not found” errors


2. Downloading the Library

Repository used:
https://github.com/Seeed-Studio/OPL_Kicad_Library

Downloaded as ZIP and extracted locally inside:

FabAcademy2026/Electronics/Exercise+Library/OPL_Kicad_Library-master/


3. Installing the Symbol Library

1. Open KiCad
2. Go to: Preferences → Manage Symbol Libraries
3. Click Add Existing Library
4. Navigate to: Seeed Studio XIAO Series Library/
5. Select: Seeed_Studio_XIAO_Series.kicad_sym
6. Add as Global Library.

Symbols are now available in the schematic editor.


4. The Footprint Problem

Inside the XIAO folder we found standalone .kicad_mod files such as:
XIAO-ESP32C6-SMD.kicad_mod
XIAO-ESP32C6-DIP.kicad_mod

Modern KiCad versions (6/7/8/9) require footprints to be inside a .pretty directory to be recognized as a footprint library.
That is why the footprint was not appearing.


5. Creating a Proper Footprint Library

A new folder was created:
Seeed_XIAO.pretty

Inside:
Seeed_XIAO.pretty/
    XIAO-ESP32C6-SMD.kicad_mod
    XIAO-ESP32C6-DIP.kicad_mod
    XIAO-ESP32C3-SMD.kicad_mod
    ...


6. Installing the Footprint Library

1. Go to: Preferences → Manage Footprint Libraries
2. Click Add Existing Library
3. Select: Seeed_XIAO.pretty
4. Library nickname: Seeed_XIAO

Now footprints appear correctly in Footprint Browser.


7. Linking Symbol to Footprint

In Symbol Editor, the Footprint field was incorrectly set to:
Module:MOUDLE14P-XIAO-DIP-SMD

This produced the error:
Cannot add U1 (footprint not found)

Corrected to:
Seeed_XIAO:XIAO-ESP32C6-DIP
(or SMD version if needed)

Symbol saved in library.


8. Important KiCad Behavior

Changing a symbol in the library does NOT update already placed instances in the schematic.

Solution:
• Delete and re-place the symbol
OR
• Manually edit footprint field in schematic

Then:
Tools → Update PCB from Schematic

No errors after correction.


9. Result

✔ Symbol properly installed
✔ Footprint properly structured
✔ Symbol ↔ footprint correctly linked
✔ PCB updates without errors
✔ Clean reusable library for future projects


10. Design Considerations

XIAO modules share identical mechanical layout across variants (RP2040, C3, C6, S3, etc.).

This allows:
• Generic socket design
• Interchangeable module PCB
• Carrier board architecture

For Fab Academy, DIP version is recommended (through-hole headers).
For production, SMD direct mounting is preferred.


Conclusion

The issue was not a KiCad bug but a footprint structure incompatibility.
By restructuring .kicad_mod files into a .pretty directory and properly linking the symbol, the XIAO ESP32-C6 module was successfully integrated into the KiCad workflow.

← Return to Index