# Troubleshooting JLCPCB Gerber Upload and CAM Tool Compatibility Errors Fix common JLCPCB Gerber upload errors including "cannot be read by CAM tool," missing board outlines, and Gerber X2 format incompatibilities. Written by [Gabriel Hacohen](#) Published Sep 2026 - 5 min read ![Troubleshooting JLCPCB Gerber Upload and CAM Tool Compatibility Errors](https://www.flux.ai/p/assets/blogs/jlcpcb-gerber-file-error/main.webp) You [exported your Gerbers from KiCad](https://docs.kicad.org/10.0/en/gerbview/gerbview.html), EasyEDA, or another EDA (electronic design automation) tool, uploaded them to JLCPCB, and hit an error. A JLCPCB Gerber file error usually traces back to a missing outline, a stray file attribute, or a zip packaged in a way JLCPCB's CAM (computer-aided manufacturing) tool doesn't expect. This guide maps the frequent rejection messages to their causes and fixes. ## Key Takeaways - ["Cannot be read by CAM tool"](#fix-cannot-be-read-by-cam-tool-error) usually comes down to zip contents, file naming, and/or unexpected Gerber X2 attributes. - [A missing or open board outline](#fix-missing-or-incorrect-board-outline) on the Edge.Cuts layer is a frequent cause of a rejected upload. - [Exporting from Flux](#exporting-clean-gerbers-from-flux-for-jlcpcb) with JLCPCB-compatible defaults avoids most of these errors before they happen. ## Common JLCPCB Gerber File Errors (And What They Mean) Why does JLCPCB reject my Gerbers? Its CAM tool parses every uploaded file before accepting an order and rejects anything that doesn't match its expected structure. The table below lists the error messages engineers run into most often, next to the cause behind each one. | **Error Message** | **Most Likely Cause** | | --- | --- | | "Cannot be read by CAM tool" | Wrong Gerber format, missing drill file, or a zip packaged incorrectly | | "Gerber file missing board outline" | Edge.Cuts layer not exported, or exported to the wrong layer | | "Excellon drill file not found" | Drill file exported separately, or left out of the zip | | "Multiple outline layers detected" | A courtyard or fabrication layer included as a second outline | | "File format not recognized" | Gerber X2 attributes the CAM tool can't parse | Each error traces to a mismatch between what your EDA tool exported and what the CAM tool expects. The sections below cover each cause, starting with the frequent ones. ## Fix: "Cannot Be Read by CAM Tool" Error This JLCPCB Gerber file error rarely comes from a single cause. Work through these checks in order: 1. **Check the zip contents.** Include only Gerber files and the drill file. A stray project file, BOM, or pick-and-place file can fail the whole upload. 2. **Confirm file extensions.** JLCPCB expects standard .gbr and .drl extensions. A zip with native project files, such as KiCad's .kicad\_pcb or EasyEDA's board file, won't parse. 3. **Re-export in standard RS-274X format.** KiCad and EasyEDA both default to Gerber X2 in current versions, which embeds metadata the CAM tool doesn't always handle cleanly. ![Only Gerbers and drill files belong in the zip, everything else gets flagged](https://www.flux.ai/p/assets/blogs/jlcpcb-gerber-file-error/body-1-main.webp) Only Gerbers and drill files belong in the zip, everything else gets flagged ## Fix: Missing or Incorrect Board Outline The CAM tool needs a clean, closed board outline to define the shape it will route and drill. Without one, it has no reference for where the board edge sits relative to your copper and hole data. - **Export Edge.Cuts as a dedicated layer**, separate from silkscreen or fabrication notes. - **Confirm the outline is a closed polygon.** Even a small gap fails outline detection. Zoom in on every corner you edited. - **Keep mechanical notes off the outline layer.** Mixing dimension lines or assembly notes into Edge.Cuts triggers "multiple outline layers detected." ## Fix: Gerber X2 Format Errors Gerber X2 format extends standard RS-274X with embedded attributes for layer function, aperture use, and net data. Gerber X2 is a genuine improvement for traceability, but JLCPCB's CAM tool doesn't parse every attribute correctly. One unrecognized line often causes the Gerber X2 format errors that PCB designers report. - **KiCad:** disable "Use extended X2 format" in the Gerber export dialog before plotting. - **EasyEDA:** switch the Gerber format setting to standard, or choose the legacy export option. - **Flux:** exports standard RS-274X by default, so no extra step is needed. If your tool doesn't expose an X2 toggle, check the header lines of each Gerber file for %TF attribute statements and strip them, though re-exporting with X2 disabled is more reliable. ## Exporting Clean Gerbers from Flux for JLCPCB Flux's Gerber export defaults are built around what fabrication houses like JLCPCB actually expect, so most of the errors above don't come up when exporting directly from Flux. - **Default format:** standard RS-274X Gerbers and an Excellon drill file, with each layer written to its own file using JLCPCB's naming convention. - **Layers to include:** a standard two-layer or four-layer board needs copper, solder mask, silkscreen, Edge.Cuts, and the drill file, pre-selected in Flux's export dialog. - **Verify before uploading:** Flux shows a Gerber preview after export. Compare it against your board layout before sending the zip to JLCPCB. Flux's [Gerber export documentation](https://docs.flux.ai/reference/gerber-export) covers the full export dialog if you want the complete reference. You can also skip the manual troubleshooting entirely by designing your next board in Flux and exporting Gerbers that JLCPCB's CAM tool accepts on the first try. ## Verifying Gerbers Before Upload A quick check before you upload catches most errors before JLCPCB's CAM tool ever sees the file. - **Use [JLCPCB's Gerber viewer](https://jlcpcb.com/RGE)** to preview the files the way its CAM tool will interpret them. - **Check outline continuity.** A visible gap or a doubled line where the outline should close is a reliable sign of a rejection. - **Check copper-to-edge clearance.** Copper touching the outline boundary in the preview often points to a layer alignment issue. - **Watch for missing layers.** If silkscreen or the drill layer doesn't render, it likely wasn't included in the zip. ## Get It Right the First Time A JLCPCB Gerber file error costs time you don't have before a deadline. Export your next board from Flux instead. Flux’s Gerber defaults already match what JLCPCB's CAM tool expects, with no X2 toggle to remember or outline layer to double-check by hand. Try exporting your board's [Gerber files from Flux](https://docs.flux.ai/reference/gerber-export) and run them through [JLCPCB's viewer](https://jlcpcb.com/RGE) before your next order. ## FAQs ### Why is JLCPCB rejecting my Gerber files? JLCPCB rejects Gerber files most often over a missing or open board outline, extra non-Gerber files in the zip, or Gerber X2 attributes its CAM tool can't parse. ### What Gerber format does JLCPCB use? JLCPCB's CAM tool works most reliably with standard RS-274X Gerber and Excellon drill files, not Gerber X2. ### How do I fix a CAM tool error on JLCPCB? Check the zip for extra files, confirm the outline is a closed polygon on its own layer, and re-export without Gerber X2 attributes if your tool defaults to that format. ### Do I need a separate drill file for JLCPCB? Yes, JLCPCB requires an Excellon drill file with the Gerbers, or the upload fails with "Excellon drill file not found." ## About the author Gabriel Hacohen Electronics Engineer at Flux Gabriel Hacohen is an electrical engineer with deep expertise in analog circuitry, medical devices, high-performance computing, and semiconductors. He holds both Bachelor's and Master's degrees in Electrical Engineering and has written for companies including NVIDIA, Cadence, Synopsys, Netflix, and Autodesk. Let’s start building Build your big idea together with Flux. All you need to do is describe what you want to make, or what problem you want to solve. Flux will work with you to make it a reality. ![Close-up photo of a PCB made with Flux, with an ESP32 module, buttons, and a microSD slot.](https://www.flux.ai/p/assets/blogs/miscellaneous/sidebar-cta-pcb.webp) [Try it Free](https://www.flux.ai/signup) ## More in Business & Strategy Library [ ![Handwritten sketches of a modern electronic device prototype](https://www.flux.ai/p/assets/blogs/hardware-startup-ideas/main.webp) ### Is Your Hardware Startup Idea Worth Building? 7 Min Read](https://www.flux.ai/p/blog/is-your-hardware-startup-idea-worth-building)[ ![A guide to collaborative PCB design showing cloud-based tools and real-time team workflows](https://www.flux.ai/p/assets/blogs/collaborative-pcb-design/main.webp) ### Collaborative PCB Design: Why Hardware Teams Are Moving to the Cloud 7 Min Read](https://www.flux.ai/p/blog/collaborative-pcb-design)[ ![Electronic components on tape reels and trays staged around a PCB, representing component sourcing for production.](https://www.flux.ai/p/assets/blogs/electronic-component-sourcing/main.webp) ### Electronic Component Sourcing: Lead Times & Component Lifecycles 9 Min Read](https://www.flux.ai/p/blog/electronic-component-sourcing)[ ![Design for manufacturing workflow taking a validated PCB prototype into scalable production.](https://www.flux.ai/p/assets/blogs/design-for-manufacturing/main.webp) ### Design for Manufacturing: How to Move from Prototype to Production 12 Min Read](https://www.flux.ai/p/blog/design-for-manufacturing)[ ![An illustration showing PCB manufacturing cost optimization strategies including layer count reduction and standard material selection](https://www.flux.ai/p/assets/blogs/pcb-cost-optimization-guide/main.webp) ### PCB Cost Optimization: How to Reduce Manufacturing Costs 6 Min Read](https://www.flux.ai/p/blog/pcb-cost-optimization-guide)[ ![An illustrated guide to IoT PCB design showing layout, power, and wireless considerations](https://www.flux.ai/p/assets/blogs/iot-pcb-design/main.webp) ### Designing PCBs for IoT Devices: Key Considerations 8 Min Read](https://www.flux.ai/p/blog/iot-pcb-design)[ ![Illustration titled '5 Common Mistakes Working with PCB Contractors' showing a PCB design tool Flux with online collaboration mouse cursor for 'Your Company' and 'PCB Contractor'. A chat message overlay from 'Marty' states, 'This isn’t going to work! We’re behind schedule now :(.'"](https://www.flux.ai/p/assets/blogs/5-common-mistakes-when-working-with-pcb-contractors/main.webp) ### 5 Common Mistakes Working with PCB Contractors 8 Min Read](https://www.flux.ai/p/blog/5-common-mistakes-working-with-pcb-contractors)[ ![Curated list of hardware founders should read](https://www.flux.ai/p/assets/blogs/hardware-founders-bookshelf/main.webp) ### The Hardware Founder’s Bookshelf 8 Min Read](https://www.flux.ai/p/blog/the-hardware-founders-bookshelf)[ ![Flux helps you design with live pricing and stock data, using AI to find in-stock parts and fast replacements before your BOM breaks.](https://www.flux.ai/p/assets/blogs/component-pricing-availability-2026/main.webp) ### Design with Real-Time Supply Chain Visibility 3 Min Read](https://www.flux.ai/p/blog/design-real-time-supply-chain-visibility-2026)[ ![A hand holding a small red printed circuit board module](https://www.flux.ai/p/assets/blogs/fearn-trade-secrets-vs-patents/main.webp) ### PCB Trade Secrets vs. Patents: How Hardware Founders Protect Electronics IP 10 Min Read](https://www.flux.ai/p/blog/pcb-trade-secrets-vs-patents)[ ![A handheld pulse oximeter representing a patented physical hardware product](https://www.flux.ai/p/assets/blogs/fearn-patent-considerations/main.webp) ### Hardware Patent Strategy for PCB Engineers: 8 Pitfalls to Avoid 11 Min Read](https://www.flux.ai/p/blog/hardware-patent-strategy-pcb-engineers)[ ![An electronic device taken apart, with every component laid out. Anyone who buys a product can do this, so a trade secret that a teardown would reveal stops being a trade secret once the product ships.](https://www.flux.ai/p/assets/blogs/fearn-defensive-publication/main.webp) ### What is a Defensive Publication? (vs. Patents and Trade Secrets) 7 Min Read](https://www.flux.ai/p/blog/what-is-a-defensive-publication)[ ![Illustration showing Git-style version control applied to PCB hardware design with branching and revision history](https://www.flux.ai/p/assets/blogs/git-for-hardware/main.webp) ### Git for Hardware: Version Control for PCB Design Teams 8 Min Read](https://www.flux.ai/p/blog/git-for-hardware)[ ![A guide to PCB version control showing revision tracking, Git workflows, and cloud collaboration for hardware teams](https://www.flux.ai/p/assets/blogs/pcb-version-control/main.webp) ### PCB Version Control Explained: How Hardware Teams Track Design Changes 8 Min Read](https://www.flux.ai/p/blog/pcb-version-control)[ ![PCB design history and revision management best practices for tracking changes and improving collaboration](https://www.flux.ai/p/assets/blogs/pcb-design-history-revision-management/main.webp) ### PCB Design History and Revision Management Best Practices 5 Min Read](https://www.flux.ai/p/blog/pcb-design-history-revision-management)[ ![Real-time PCB collaboration showing how modern hardware teams design together in a shared workspace](https://www.flux.ai/p/assets/blogs/real-time-pcb-collaboration/main.webp) ### Real-Time PCB Collaboration: How Modern Teams Design Together 7 Min Read](https://www.flux.ai/p/blog/real-time-pcb-collaboration)[ ![Copilot scanning a board for components with EOL and NRND lifecycle status](https://www.flux.ai/p/assets/blogs/ai-supply-chain/main.webp) ### AI Gives You the Power of an Entire Supply-Chain Team 3 Min Read](https://www.flux.ai/p/blog/ai-gives-you-the-power-of-an-entire-supply-chain-team)[ ![A guide to PCB component library management showing symbols, footprints, and 3D models for hardware design](https://www.flux.ai/p/assets/blogs/pcb-component-library-management/main.webp) ### PCB Component Libraries: Best Practices for Managing Parts 7 Min Read](https://www.flux.ai/p/blog/pcb-component-library-management)[ ![A guide to creating and managing PCB footprint libraries using IPC standards and validation best practices](https://www.flux.ai/p/assets/blogs/pcb-footprint-library-management/main.webp) ### How to Create and Manage PCB Footprint Libraries 6 Min Read](https://www.flux.ai/p/blog/pcb-footprint-library-management)[ ![PCB library management showing how hardware teams standardize components across projects with centralized libraries](https://www.flux.ai/p/assets/blogs/pcb-library-management/main.webp) ### PCB Library Management: How to Standardize Components Across Teams 7 Min Read](https://www.flux.ai/p/blog/pcb-library-management)[ ![Flux for Librarians](https://www.flux.ai/p/assets/blogs/flux-for-librarians/main.webp) ### Flux for Librarians 4 Min Read](https://www.flux.ai/p/blog/flux-for-librarians)[ ![Prototyping vs. Production-Ready Electrical Engineering](https://www.flux.ai/p/assets/blogs/biskuit-ai/main.webp) ### Prototyping vs. Production-Ready Electrical Engineering 6 Min Read](https://www.flux.ai/p/blog/prototyping-vs-production-ready-electrical-engineering-the-same-game-different-tradeoffs)[ ![PCB Manufacturing Process Explained Step-by-Step](https://www.flux.ai/p/assets/blogs/pcb-manufacturing-process/main.webp) ### PCB Manufacturing Process Explained Step-by-Step 16 Min Read](https://www.flux.ai/p/blog/pcb-manufacturing-process)[ ![PCB design documentation checklist showing essential manufacturing package files including Gerbers, BOMs, and assembly drawings](https://www.flux.ai/p/assets/blogs/pcb-design-documentation/main.webp) ### PCB Design Documentation: What Every Manufacturing Package Should Include 7 Min Read](https://www.flux.ai/p/blog/pcb-design-documentation)[ ![PCB Design for Manufacturability (DFM): Rules and Best Practices](https://www.flux.ai/p/assets/blogs/pcb-design-for-manufacturability-dfm/main.webp) ### PCB Design for Manufacturability (DFM): Rules and Best Practices 8 Min Read](https://www.flux.ai/p/blog/pcb-design-for-manufacturability-dfm)[ ![An illustrated guide to PCB panelization methods and best practices for manufacturing](https://www.flux.ai/p/assets/blogs/pcb-panelization/main.webp) ### Panelization in PCB Manufacturing: Methods and Best Practices 6 Min Read](https://www.flux.ai/p/blog/pcb-panelization)[ ![A detailed illustration comparing PCB prototyping and production fabrication processes for hardware development](https://www.flux.ai/p/assets/blogs/pcb-prototyping-vs-fabrication/main.webp) ### PCB Prototyping vs. Fabrication: Which Process Is Right for Your Project? 8 Min Read](https://www.flux.ai/p/blog/pcb-prototyping-vs-fabrication)[ ![A guide to PCB reverse engineering showing board analysis, schematic extraction, and common use cases](https://www.flux.ai/p/assets/blogs/pcb-reverse-engineering/main.webp) ### PCB Reverse Engineering: How It Works and When to Use It 8 Min Read](https://www.flux.ai/p/blog/pcb-reverse-engineering)[ ![Illustration for PCB Testing Methods: Ensuring Quality and Reliability](https://www.flux.ai/p/assets/blogs/pcb-testing-methods/main.webp) ### PCB Testing Methods: Ensuring Quality and Reliability 5 Min Read](https://www.flux.ai/p/blog/pcb-testing-methods)[ ![Close-up view of a pick-and-place machine in a PCB manufacturing facility, automating the process of placing components and circuit board printing.](https://www.flux.ai/p/assets/blogs/pcb-manufacturing/main.webp) ### Discovering PCB Manufacturing: Technologies That Shape the Industry 3 Min Read](https://www.flux.ai/p/blog/discovering-pcb-manufacturing-technologies-that-shape-the-industry)[ ![PCB layer stack cross-section mapped to the Gerber and NC drill files that define each layer](https://www.flux.ai/p/assets/blogs/gerber-files-explained/main.webp) ### Gerber Files Explained: PCB Layers, Formats & Export 8 Min Read](https://www.flux.ai/p/blog/gerber-files-explained)[ ![PCBA workflow sequence showing eight stages from bare PCB to electrical testing](https://www.flux.ai/p/assets/blogs/what-is-pcba/main.webp) ### What Is PCBA? PCB vs PCBA and Assembly Explained 7 Min Read](https://www.flux.ai/p/blog/what-is-pcba)[ ![Reflow soldering thermal profile overlaid on a populated PCB, showing the preheat, soak, spike, and cooling zones](https://www.flux.ai/p/assets/blogs/what-is-a-reflow-oven/main.webp) ### What Is a Reflow Oven? PCB Reflow Soldering Explained 7 Min Read](https://www.flux.ai/p/blog/what-is-a-reflow-oven) See All (33) ## Let’s start building. Let’s build your idea together. All you need to do is describe what you want to make, or what problem you want to solve. Flux will work with you to make it a reality. [Try it Free](https://www.flux.ai/signup) ![Close-up of a Flux-designed printed circuit board](https://www.flux.ai/p/assets/homepage-v2/mission-visual.webp)