JLCPCB — PCB Fabrication & Assembly
JLCPCB is a PCB fabrication and assembly service based in Shenzhen, China. It is a sister company to LCSC Electronics (common ownership) — they share the same parts library.
Typical usage: Order bare prototype PCBs + framed stencil from JLCPCB during prototyping (parts sourced separately from DigiKey/Mouser, hand-assembled in lab). For production runs (100s qty), order fully assembled boards from JLCPCB using LCSC parts. PCBWay is an alternative assembler. For component searching, see the lcsc skill. For BOM management, gerber/CPL export, and stencil ordering, see the bom skill.
Related Skills
| Skill |
Purpose |
kicad |
Read/analyze KiCad project files, DFM scoring against JLCPCB capabilities |
bom |
BOM management, gerber/CPL export, stencil ordering |
digikey |
Search DigiKey (prototype sourcing, primary — also preferred for datasheet downloads via API) |
mouser |
Search Mouser (prototype sourcing, secondary) |
lcsc |
Search LCSC (production sourcing — JLCPCB uses LCSC parts library) |
pcbway |
Alternative PCB fabrication & assembly |
emc |
EMC pre-compliance risk analysis — run before fab to catch EMC issues |
spice |
SPICE simulation — verify analog subcircuits before committing to fab |
Assembly Parts Library
Part Categories
| Category |
Description |
Assembly Fee |
| Basic |
Common parts (resistors, caps, diodes, common ICs) pre-loaded on pick-and-place machines |
No extra fee |
| Extended |
300k+ less common parts loaded on demand |
$3 per unique extended part |
JLCPCB occasionally promotes a subset of frequently-used extended parts with a discounted or waived feeder fee (the program's name and terms shift over time). Check the current JLCPCB parts library page for any specific extended part before assuming the standard $3 fee applies.
LCSC Part Numbers
Every assembly component is identified by an LCSC Part Number (Cxxxxx, e.g., C14663). This is the definitive identifier for BOM matching. See the lcsc skill for searching parts.
Parts Search (JLCPCB-Specific)
- Parts library:
https://jlcpcb.com/parts/componentSearch?searchTxt=<query>
- Basic parts only:
https://jlcpcb.com/parts/basic_parts
BOM Format for Assembly
JLCPCB accepts CSV, XLS, or XLSX BOMs with these columns:
| Column |
Required |
Description |
Comment / Value |
Yes |
Component value (e.g., 100nF, 10k) |
Designator |
Yes |
Reference designators, comma-separated (e.g., C1,C2,C5) |
Footprint |
Yes |
Package/footprint name |
LCSC Part # |
Recommended |
LCSC part number (Cxxxxx) — guarantees exact match |
The column header for LCSC numbers must be exactly "LCSC Part #" or "LCSC Part Number" — typos cause upload failures.
KiCad BOM Export for JLCPCB
- In KiCad schematic editor, add an
LCSC field to each symbol with the LCSC part number
- Export BOM as CSV with columns: Reference, Value, Footprint, LCSC
- Rename columns to match JLCPCB's expected format:
Reference -> Designator
Value -> Comment
Footprint -> Footprint
LCSC -> LCSC Part #
For gerber export settings, CPL format, and stencil ordering, see the bom skill.
JLCPCB Official API (Approval Required)
Apply at https://api.jlcpcb.com. Access is gated — requires review based on order history and business profile.
Available APIs (once approved):
- Components API — real-time pricing, inventory, component specs
- PCB API — upload gerbers, get quotes, place orders, track status
- Stencil API — stencil quoting and ordering
- 3D Printing API — SLA/MJF/SLM/FDM ordering
PCB Design Rules (JLCPCB Capabilities)
Standard PCB (1-2 layers)
| Parameter |
Minimum |
| Trace width |
0.127mm (5mil) |
| Trace spacing |
0.127mm (5mil) |
| Via diameter |
0.45mm |
| Via drill |
0.2mm |
| Annular ring |
0.125mm |
| Min hole size |
0.2mm |
| Board thickness |
0.4-2.4mm (default 1.6mm) |
| Min board size |
6x6mm |
| Max board size |
500x400mm (2-layer) |
Multi-layer (4+ layers)
| Parameter |
Minimum |
| Trace width |
0.09mm (3.5mil) |
| Trace spacing |
0.09mm (3.5mil) |
| Via diameter |
0.25mm |
| Via drill |
0.15mm |
| Board thickness |
0.6-2.4mm |
Importing DRU into KiCad
If you have a JLCPCB .kicad_dru design rules file, import it in KiCad Board Editor > Board Setup > Design Rules > Import Settings.
Assembly Constraints
Economic vs Standard Assembly
| Feature |
Economic |
Standard |
| Sides |
Top only |
Top + Bottom |
| Component types |
SMD only |
SMD + through-hole |
| Min component size |
0201 |
01005 |
| Fine-pitch BGA/QFP |
Down to 0.5mm pitch |
Down to 0.4mm pitch |
| Turnaround |
~3-5 days |
~3-5 days |
| Extended part fee |
$3 per unique part |
$3 per unique part |
General Constraints
- Minimum order: 5 PCBs for assembly
- Unique parts limit: No hard limit, but each extended part adds $3
- Basic parts: No extra fee, pre-loaded on machines
Rotation Offsets
JLCPCB's pick-and-place uses different rotation conventions than KiCad for some footprints. Common offsets:
| Footprint Family |
Typical Offset |
| SOT-23, SOT-23-5, SOT-23-6 |
+180° |
| SOT-223 |
+180° |
| SOIC-8, SOIC-16 |
+90° or +270° |
| QFN (all sizes) |
+90° |
| SMA/SMB/SMC diodes |
+180° |
| USB-C connectors |
Varies — check datasheet |
To fix rotation issues:
- Add rotation corrections directly in the CPL file before uploading (adjust the Rotation column)
- For custom footprints, verify pin 1 orientation matches JLCPCB expectations
- JLCPCB's review step catches major errors, but subtle 180° rotations on symmetric parts (caps, resistors) may slip through
- After first assembly order, note any rotation corrections needed and apply them to future CPL exports
Ordering Workflow
Prototype Order (Bare PCB + Stencil)
- Export gerbers from KiCad (see
bom skill for export settings)
- Upload gerbers to
https://cart.jlcpcb.com/quote — configure layers, thickness, color, qty
- Add a framed stencil to the cart (uses paste layers from your gerbers)
- Order — PCBs and stencil typically arrive in ~1 week
Production Order (Assembled Boards)
- Export gerbers from KiCad (see
bom skill for export settings)
- Export BOM as CSV with LCSC part numbers (format above)
- Export CPL (placement file) as CSV (see
bom skill for format)
- Upload gerbers to
https://cart.jlcpcb.com/quote — configure layers, thickness, color, qty
- Enable "PCB Assembly", select Economic or Standard
- Upload BOM and CPL files
- Review part matching — fix any unmatched parts by searching LCSC numbers
- Confirm and order
Translating Altium / KiCad BOM and CPL files
For boards exported from Altium (or other tools) whose BOM/CPL formats
don't match JLCPCB's expected columns, the bom skill ships
translate_bom_pnp.py to convert them. <bom-skill-path> is the installed bom skill directory. Two subcommands:
# BOM: KiCad/Altium CSV → JLCPCB BOM CSV (Comment, Designator, Footprint,
# LCSC Part #, MPN, Manufacturer,
# Quantity, Notes), DNP rows left out, R1-R4 expanded.
# LCSC Part # is written empty even if the input has one:
# fill it before upload.
python3 <bom-skill-path>/scripts/translate_bom_pnp.py bom input_bom.csv -o jlc_bom.csv
# CPL: input CPL → JLCPCB Pick-and-Place CSV (Designator, Mid X, Mid Y,
# Layer, Rotation), with mil→mm
# and TopLayer/BottomLayer
# normalization
python3 <bom-skill-path>/scripts/translate_bom_pnp.py pnp input_cpl.csv -o jlc_cpl.csv --units <in|mm>
# (--units must name the unit the file was exported in: a KiCad position CSV
# has no unit marker and kicad-cli exports inches unless told --units mm)
The 3-step PCBA upload workflow (avoids rejection)
JLCPCB's PCBA web upload rejects orders when the CPL contains designators
that aren't in the BOM (mechanical holes, fiducials, test points, etc.
that appear in the CPL output but aren't assembly components). The
translator's --bom filter mode solves this:
Translate the BOM first — produces the JLCPCB-format BOM and
establishes the authoritative designator set:
python3 <bom-skill-path>/scripts/translate_bom_pnp.py bom input_bom.csv -o jlc_bom.csv
Translate the CPL with --bom filter — intersects CPL designators
with BOM designators, dropping orphans:
python3 <bom-skill-path>/scripts/translate_bom_pnp.py pnp input_cpl.csv -o jlc_cpl.csv --units <in|mm> --bom jlc_bom.csv
The returned filtered_orphans count plus filtered_orphan_samples
list lets the operator confirm which CPL rows were dropped — sanity-
check this list before uploading. Common orphans (mounting holes,
fiducials, test points) are expected; anything else may indicate a
BOM/PCB mismatch worth investigating.
Tabulate consigned-parts cost separately — JLCPCB's quote does
not auto-itemize consigned (user-supplied) part costs. Build a quote
summary that shows: PCB fabrication, PCBA assembly fee, basic vs
extended parts cost (per JLCPCB invoice), and a separate
user-sourced parts subtotal. Without this breakdown the quote
understates true unit cost by the consigned-parts amount.
This workflow is documented because JLCPCB's web upload UX silently
rejects orphan-designator CPLs with an unhelpful error; the parity
check via --bom is the single highest-value step in shipping a
clean PCBA order.
Tips
- Prefer Basic parts — no extra fee, always in stock, faster assembly
- Check stock before ordering — extended parts can go out of stock; use the
lcsc skill to search
- Panel by JLCPCB — for small boards, let JLCPCB panelize (cheaper) vs custom panels
- Lead-free solder — default is leaded (HASL); select lead-free HASL or ENIG if needed
- Impedance control — available for multi-layer boards, specify stackup in order notes
- Castellated holes — supported, enable in order options
- V-cuts and mouse bites — supported for panel separation
- Silkscreen minimum — 0.8mm height, 0.15mm line width for readable text
- Edge clearance — keep copper >=0.3mm from board edge (0.5mm recommended)
1---2name: jlcpcb3description: JLCPCB PCB fabrication and assembly — BOM/CPL generation, basic vs extended parts, assembly constraints, design rules, ordering workflow. Use with KiCad for JLCPCB manufacturing. Use this skill when the user mentions JLCPCB, wants to order PCBs or assembled boards, needs prototype bare PCBs and stencils, wants to know JLCPCB design rules and capabilities, or is asking about PCB manufacturing costs or turnaround times. For gerber/CPL export, stencil ordering, and BOM management, see the `bom` skill.4metadata:5 source: https://skillmd.com/skills/hashgraph-online/jlcpcb6---78# JLCPCB — PCB Fabrication & Assembly910JLCPCB is a PCB fabrication and assembly service based in Shenzhen, China. It is a sister company to LCSC Electronics (common ownership) — they share the same parts library.1112**Typical usage**: Order bare prototype PCBs + framed stencil from JLCPCB during prototyping (parts sourced separately from DigiKey/Mouser, hand-assembled in lab). For production runs (100s qty), order fully assembled boards from JLCPCB using LCSC parts. PCBWay is an alternative assembler. For component searching, see the `lcsc` skill. For BOM management, gerber/CPL export, and stencil ordering, see the `bom` skill.1314## Related Skills1516| Skill | Purpose |17|-------|---------|18| `kicad` | Read/analyze KiCad project files, DFM scoring against JLCPCB capabilities |19| `bom` | BOM management, gerber/CPL export, stencil ordering |20| `digikey` | Search DigiKey (prototype sourcing, primary — also preferred for datasheet downloads via API) |21| `mouser` | Search Mouser (prototype sourcing, secondary) |22| `lcsc` | Search LCSC (production sourcing — JLCPCB uses LCSC parts library) |23| `pcbway` | Alternative PCB fabrication & assembly |24| `emc` | EMC pre-compliance risk analysis — run before fab to catch EMC issues |25| `spice` | SPICE simulation — verify analog subcircuits before committing to fab |2627## Assembly Parts Library2829### Part Categories3031| Category | Description | Assembly Fee |32|----------|-------------|--------------|33| **Basic** | Common parts (resistors, caps, diodes, common ICs) pre-loaded on pick-and-place machines | No extra fee |34| **Extended** | 300k+ less common parts loaded on demand | $3 per unique extended part |3536> JLCPCB occasionally promotes a subset of frequently-used extended parts with a discounted or waived feeder fee (the program's name and terms shift over time). Check the current JLCPCB parts library page for any specific extended part before assuming the standard $3 fee applies.3738### LCSC Part Numbers3940Every assembly component is identified by an **LCSC Part Number** (`Cxxxxx`, e.g., `C14663`). This is the definitive identifier for BOM matching. See the `lcsc` skill for searching parts.4142### Parts Search (JLCPCB-Specific)4344- Parts library: `https://jlcpcb.com/parts/componentSearch?searchTxt=<query>`45- Basic parts only: `https://jlcpcb.com/parts/basic_parts`4647## BOM Format for Assembly4849JLCPCB accepts CSV, XLS, or XLSX BOMs with these columns:5051| Column | Required | Description |52|--------|----------|-------------|53| `Comment` / `Value` | Yes | Component value (e.g., 100nF, 10k) |54| `Designator` | Yes | Reference designators, comma-separated (e.g., C1,C2,C5) |55| `Footprint` | Yes | Package/footprint name |56| `LCSC Part #` | Recommended | LCSC part number (Cxxxxx) — guarantees exact match |5758The column header for LCSC numbers must be exactly **"LCSC Part #"** or **"LCSC Part Number"** — typos cause upload failures.5960### KiCad BOM Export for JLCPCB61621. In KiCad schematic editor, add an `LCSC` field to each symbol with the LCSC part number632. Export BOM as CSV with columns: Reference, Value, Footprint, LCSC643. Rename columns to match JLCPCB's expected format:65 - `Reference` -> `Designator`66 - `Value` -> `Comment`67 - `Footprint` -> `Footprint`68 - `LCSC` -> `LCSC Part #`6970For gerber export settings, CPL format, and stencil ordering, see the `bom` skill.7172## JLCPCB Official API (Approval Required)7374Apply at `https://api.jlcpcb.com`. Access is gated — requires review based on order history and business profile.7576Available APIs (once approved):77- **Components API** — real-time pricing, inventory, component specs78- **PCB API** — upload gerbers, get quotes, place orders, track status79- **Stencil API** — stencil quoting and ordering80- **3D Printing API** — SLA/MJF/SLM/FDM ordering8182## PCB Design Rules (JLCPCB Capabilities)8384### Standard PCB (1-2 layers)8586| Parameter | Minimum |87|-----------|---------|88| Trace width | 0.127mm (5mil) |89| Trace spacing | 0.127mm (5mil) |90| Via diameter | 0.45mm |91| Via drill | 0.2mm |92| Annular ring | 0.125mm |93| Min hole size | 0.2mm |94| Board thickness | 0.4-2.4mm (default 1.6mm) |95| Min board size | 6x6mm |96| Max board size | 500x400mm (2-layer) |9798### Multi-layer (4+ layers)99100| Parameter | Minimum |101|-----------|---------|102| Trace width | 0.09mm (3.5mil) |103| Trace spacing | 0.09mm (3.5mil) |104| Via diameter | 0.25mm |105| Via drill | 0.15mm |106| Board thickness | 0.6-2.4mm |107108### Importing DRU into KiCad109110If you have a JLCPCB `.kicad_dru` design rules file, import it in KiCad Board Editor > Board Setup > Design Rules > Import Settings.111112## Assembly Constraints113114### Economic vs Standard Assembly115116| Feature | Economic | Standard |117|---------|----------|----------|118| Sides | Top only | Top + Bottom |119| Component types | SMD only | SMD + through-hole |120| Min component size | 0201 | 01005 |121| Fine-pitch BGA/QFP | Down to 0.5mm pitch | Down to 0.4mm pitch |122| Turnaround | ~3-5 days | ~3-5 days |123| Extended part fee | $3 per unique part | $3 per unique part |124125### General Constraints126127- **Minimum order**: 5 PCBs for assembly128- **Unique parts limit**: No hard limit, but each extended part adds $3129- **Basic parts**: No extra fee, pre-loaded on machines130131## Rotation Offsets132133JLCPCB's pick-and-place uses different rotation conventions than KiCad for some footprints. Common offsets:134135| Footprint Family | Typical Offset |136|-----------------|----------------|137| SOT-23, SOT-23-5, SOT-23-6 | +180° |138| SOT-223 | +180° |139| SOIC-8, SOIC-16 | +90° or +270° |140| QFN (all sizes) | +90° |141| SMA/SMB/SMC diodes | +180° |142| USB-C connectors | Varies — check datasheet |143144To fix rotation issues:1451. Add rotation corrections directly in the CPL file before uploading (adjust the Rotation column)1462. For custom footprints, verify pin 1 orientation matches JLCPCB expectations1473. JLCPCB's review step catches major errors, but subtle 180° rotations on symmetric parts (caps, resistors) may slip through1484. After first assembly order, note any rotation corrections needed and apply them to future CPL exports149150## Ordering Workflow151152### Prototype Order (Bare PCB + Stencil)1531541. **Export gerbers** from KiCad (see `bom` skill for export settings)1552. Upload gerbers to `https://cart.jlcpcb.com/quote` — configure layers, thickness, color, qty1563. Add a **framed stencil** to the cart (uses paste layers from your gerbers)1574. Order — PCBs and stencil typically arrive in ~1 week158159### Production Order (Assembled Boards)1601611. **Export gerbers** from KiCad (see `bom` skill for export settings)1622. **Export BOM** as CSV with LCSC part numbers (format above)1633. **Export CPL** (placement file) as CSV (see `bom` skill for format)1644. Upload gerbers to `https://cart.jlcpcb.com/quote` — configure layers, thickness, color, qty1655. Enable "PCB Assembly", select Economic or Standard1666. Upload BOM and CPL files1677. Review part matching — fix any unmatched parts by searching LCSC numbers1688. Confirm and order169170### Translating Altium / KiCad BOM and CPL files171172For boards exported from Altium (or other tools) whose BOM/CPL formats173don't match JLCPCB's expected columns, the `bom` skill ships174`translate_bom_pnp.py` to convert them. `<bom-skill-path>` is the installed bom skill directory. Two subcommands:175176```bash177# BOM: KiCad/Altium CSV → JLCPCB BOM CSV (Comment, Designator, Footprint,178# LCSC Part #, MPN, Manufacturer,179# Quantity, Notes), DNP rows left out, R1-R4 expanded.180# LCSC Part # is written empty even if the input has one:181# fill it before upload.182python3 <bom-skill-path>/scripts/translate_bom_pnp.py bom input_bom.csv -o jlc_bom.csv183184# CPL: input CPL → JLCPCB Pick-and-Place CSV (Designator, Mid X, Mid Y,185# Layer, Rotation), with mil→mm186# and TopLayer/BottomLayer187# normalization188python3 <bom-skill-path>/scripts/translate_bom_pnp.py pnp input_cpl.csv -o jlc_cpl.csv --units <in|mm>189# (--units must name the unit the file was exported in: a KiCad position CSV190# has no unit marker and kicad-cli exports inches unless told --units mm)191```192193#### The 3-step PCBA upload workflow (avoids rejection)194195JLCPCB's PCBA web upload rejects orders when the CPL contains designators196that aren't in the BOM (mechanical holes, fiducials, test points, etc.197that appear in the CPL output but aren't assembly components). The198translator's `--bom` filter mode solves this:1992001. **Translate the BOM first** — produces the JLCPCB-format BOM and201 establishes the authoritative designator set:202 ```bash203 python3 <bom-skill-path>/scripts/translate_bom_pnp.py bom input_bom.csv -o jlc_bom.csv204 ```2052062. **Translate the CPL with `--bom` filter** — intersects CPL designators207 with BOM designators, dropping orphans:208 ```bash209 python3 <bom-skill-path>/scripts/translate_bom_pnp.py pnp input_cpl.csv -o jlc_cpl.csv --units <in|mm> --bom jlc_bom.csv210 ```211 The returned `filtered_orphans` count plus `filtered_orphan_samples`212 list lets the operator confirm which CPL rows were dropped — sanity-213 check this list before uploading. Common orphans (mounting holes,214 fiducials, test points) are expected; anything else may indicate a215 BOM/PCB mismatch worth investigating.2162173. **Tabulate consigned-parts cost separately** — JLCPCB's quote does218 not auto-itemize consigned (user-supplied) part costs. Build a quote219 summary that shows: PCB fabrication, PCBA assembly fee, basic vs220 extended parts cost (per JLCPCB invoice), and a separate221 user-sourced parts subtotal. Without this breakdown the quote222 understates true unit cost by the consigned-parts amount.223224This workflow is documented because JLCPCB's web upload UX silently225rejects orphan-designator CPLs with an unhelpful error; the parity226check via `--bom` is the single highest-value step in shipping a227clean PCBA order.228229## Tips230231- **Prefer Basic parts** — no extra fee, always in stock, faster assembly232- **Check stock before ordering** — extended parts can go out of stock; use the `lcsc` skill to search233- **Panel by JLCPCB** — for small boards, let JLCPCB panelize (cheaper) vs custom panels234- **Lead-free solder** — default is leaded (HASL); select lead-free HASL or ENIG if needed235- **Impedance control** — available for multi-layer boards, specify stackup in order notes236- **Castellated holes** — supported, enable in order options237- **V-cuts and mouse bites** — supported for panel separation238- **Silkscreen minimum** — 0.8mm height, 0.15mm line width for readable text239- **Edge clearance** — keep copper >=0.3mm from board edge (0.5mm recommended)