[{"data":1,"prerenderedAt":818},["ShallowReactive",2],{"docs-navigation":3,"\u002Fdocs\u002Fguides\u002Fimporting-files":231,"\u002Fdocs\u002Fguides\u002Fimporting-files-surround":813},[4],{"title":5,"path":6,"stem":7,"children":8},"Docs","\u002Fdocs","docs",[9,12,16,20,69,90,123,144,165,190],{"title":10,"path":6,"stem":11},"Gerbtrace Documentation","docs\u002Findex",{"title":13,"path":14,"stem":15},"Getting Started","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started",{"title":17,"path":18,"stem":19},"Licensing","\u002Fdocs\u002Flicensing","docs\u002F2.licensing",{"title":21,"path":22,"stem":23,"children":24,"page":68},"Viewer","\u002Fdocs\u002Fviewer","docs\u002F3.viewer",[25,29,33,37,41,45,49,53,56,60,64],{"title":26,"path":27,"stem":28},"Files","\u002Fdocs\u002Fviewer\u002Ffiles","docs\u002F3.viewer\u002F01.files",{"title":30,"path":31,"stem":32},"PCB","\u002Fdocs\u002Fviewer\u002Fpcb","docs\u002F3.viewer\u002F02.pcb",{"title":34,"path":35,"stem":36},"Panel","\u002Fdocs\u002Fviewer\u002Fpanel","docs\u002F3.viewer\u002F03.panel",{"title":38,"path":39,"stem":40},"Paste","\u002Fdocs\u002Fviewer\u002Fpaste","docs\u002F3.viewer\u002F04.paste",{"title":42,"path":43,"stem":44},"SMD","\u002Fdocs\u002Fviewer\u002Fsmd","docs\u002F3.viewer\u002F05.smd",{"title":46,"path":47,"stem":48},"THT","\u002Fdocs\u002Fviewer\u002Ftht","docs\u002F3.viewer\u002F06.tht",{"title":50,"path":51,"stem":52},"BOM","\u002Fdocs\u002Fviewer\u002Fbom","docs\u002F3.viewer\u002F07.bom",{"title":5,"path":54,"stem":55},"\u002Fdocs\u002Fviewer\u002Fdocs","docs\u002F3.viewer\u002F08.docs",{"title":57,"path":58,"stem":59},"Conversation","\u002Fdocs\u002Fviewer\u002Fconversation","docs\u002F3.viewer\u002F09.conversation",{"title":61,"path":62,"stem":63},"Summary","\u002Fdocs\u002Fviewer\u002Fsummary","docs\u002F3.viewer\u002F10.summary",{"title":65,"path":66,"stem":67},"Pricing","\u002Fdocs\u002Fviewer\u002Fpricing","docs\u002F3.viewer\u002F11.pricing",false,{"title":70,"path":71,"stem":72,"children":73,"page":68},"Tools","\u002Fdocs\u002Ftools","docs\u002F4.tools",[74,78,82,86],{"title":75,"path":76,"stem":77},"Exports","\u002Fdocs\u002Ftools\u002Fexports","docs\u002F4.tools\u002F1.exports",{"title":79,"path":80,"stem":81},"Compare","\u002Fdocs\u002Ftools\u002Fcompare","docs\u002F4.tools\u002F2.compare",{"title":83,"path":84,"stem":85},"Package Manager","\u002Fdocs\u002Ftools\u002Fpackage-manager","docs\u002F4.tools\u002F3.package-manager",{"title":87,"path":88,"stem":89},"Draw Tool","\u002Fdocs\u002Ftools\u002Fdraw-tool","docs\u002F4.tools\u002F4.draw-tool",{"title":91,"path":92,"stem":93,"children":94,"page":68},"Collaboration","\u002Fdocs\u002Fcollaboration","docs\u002F5.collaboration",[95,99,103,107,111,115,119],{"title":96,"path":97,"stem":98},"Team Settings","\u002Fdocs\u002Fcollaboration\u002Fteam-settings","docs\u002F5.collaboration\u002F1.team-settings",{"title":100,"path":101,"stem":102},"Team Members","\u002Fdocs\u002Fcollaboration\u002Fteam-members","docs\u002F5.collaboration\u002F2.team-members",{"title":104,"path":105,"stem":106},"User Profile","\u002Fdocs\u002Fcollaboration\u002Fuser-profile","docs\u002F5.collaboration\u002F3.user-profile",{"title":108,"path":109,"stem":110},"Spaces","\u002Fdocs\u002Fcollaboration\u002Fspaces","docs\u002F5.collaboration\u002F4.spaces",{"title":112,"path":113,"stem":114},"Notifications","\u002Fdocs\u002Fcollaboration\u002Fnotifications","docs\u002F5.collaboration\u002F6.notifications",{"title":116,"path":117,"stem":118},"Plans & Billing","\u002Fdocs\u002Fcollaboration\u002Fplans-and-billing","docs\u002F5.collaboration\u002F7.plans-and-billing",{"title":120,"path":121,"stem":122},"Connected Apps & MCP","\u002Fdocs\u002Fcollaboration\u002Fconnected-apps","docs\u002F5.collaboration\u002F8.connected-apps",{"title":124,"path":125,"stem":126,"children":127,"page":68},"App","\u002Fdocs\u002Fapp","docs\u002F6.app",[128,132,136,140],{"title":129,"path":130,"stem":131},"Desktop App","\u002Fdocs\u002Fapp\u002Fdesktop","docs\u002F6.app\u002F1.desktop",{"title":133,"path":134,"stem":135},"Light & Dark Mode","\u002Fdocs\u002Fapp\u002Flight-dark-mode","docs\u002F6.app\u002F2.light-dark-mode",{"title":137,"path":138,"stem":139},"Performance Monitor","\u002Fdocs\u002Fapp\u002Fperformance-monitor","docs\u002F6.app\u002F3.performance-monitor",{"title":141,"path":142,"stem":143},"Report a Bug","\u002Fdocs\u002Fapp\u002Freport-a-bug","docs\u002F6.app\u002F4.report-a-bug",{"title":145,"path":146,"stem":147,"children":148,"page":68},"Guides","\u002Fdocs\u002Fguides","docs\u002F7.guides",[149,153,157,161],{"title":150,"path":151,"stem":152},"Importing Files","\u002Fdocs\u002Fguides\u002Fimporting-files","docs\u002F7.guides\u002F1.importing-files",{"title":154,"path":155,"stem":156},"Supported Formats","\u002Fdocs\u002Fguides\u002Fsupported-formats","docs\u002F7.guides\u002F2.supported-formats",{"title":158,"path":159,"stem":160},"Package Library","\u002Fdocs\u002Fguides\u002Fpackage-library","docs\u002F7.guides\u002F3.package-library",{"title":162,"path":163,"stem":164},"Panel Checks","\u002Fdocs\u002Fguides\u002Fpanel-checks","docs\u002F7.guides\u002F4.panel-checks",{"title":166,"path":167,"stem":168,"children":169,"page":68},"Reference","\u002Fdocs\u002Freference","docs\u002F8.reference",[170,174,178,182,186],{"title":171,"path":172,"stem":173},"BOM File Format","\u002Fdocs\u002Freference\u002Fbom-format","docs\u002F8.reference\u002F1.bom-format",{"title":175,"path":176,"stem":177},"Package Definitions","\u002Fdocs\u002Freference\u002Fpackage-definitions","docs\u002F8.reference\u002F2.package-definitions",{"title":179,"path":180,"stem":181},"Package Naming","\u002Fdocs\u002Freference\u002Fpackage-naming","docs\u002F8.reference\u002F3.package-naming",{"title":183,"path":184,"stem":185},"TPSys Format","\u002Fdocs\u002Freference\u002Ftpsys-format","docs\u002F8.reference\u002F4.tpsys-format",{"title":187,"path":188,"stem":189},"Jet Printing","\u002Fdocs\u002Freference\u002Fjet-printing","docs\u002F8.reference\u002F5.jet-printing",{"title":191,"path":192,"stem":193,"children":194,"page":68},"Development","\u002Fdocs\u002Fdevelopment","docs\u002F9.development",[195,199,203,207,211,215,219,223,227],{"title":196,"path":197,"stem":198},"Development Setup","\u002Fdocs\u002Fdevelopment\u002Fsetup","docs\u002F9.development\u002F1.setup",{"title":200,"path":201,"stem":202},"Architecture","\u002Fdocs\u002Fdevelopment\u002Farchitecture","docs\u002F9.development\u002F2.architecture",{"title":204,"path":205,"stem":206},"CAD Libraries","\u002Fdocs\u002Fdevelopment\u002Fcad-libraries","docs\u002F9.development\u002F3.cad-libraries",{"title":208,"path":209,"stem":210},"Release Process","\u002Fdocs\u002Fdevelopment\u002Frelease-process","docs\u002F9.development\u002F4.release-process",{"title":212,"path":213,"stem":214},"Error Monitoring","\u002Fdocs\u002Fdevelopment\u002Ferror-monitoring","docs\u002F9.development\u002F5.error-monitoring",{"title":216,"path":217,"stem":218},"Contributing","\u002Fdocs\u002Fdevelopment\u002Fcontributing","docs\u002F9.development\u002F6.contributing",{"title":220,"path":221,"stem":222},"Commit Conventions","\u002Fdocs\u002Fdevelopment\u002Fcommit-conventions","docs\u002F9.development\u002F7.commit-conventions",{"title":224,"path":225,"stem":226},"Sidebar Design","\u002Fdocs\u002Fdevelopment\u002Fsidebar-design","docs\u002F9.development\u002F8.sidebar-design",{"title":228,"path":229,"stem":230},"Operational Runbooks","\u002Fdocs\u002Fdevelopment\u002Frunbooks","docs\u002F9.development\u002F9.runbooks",{"id":232,"title":150,"body":233,"description":806,"extension":807,"links":808,"meta":809,"navigation":810,"path":151,"seo":811,"stem":152,"__hash__":812},"docs\u002Fdocs\u002F7.guides\u002F1.importing-files.md",{"type":234,"value":235,"toc":781},"minimark",[236,240,248,253,258,261,265,268,272,410,417,421,424,428,432,435,571,578,582,607,611,626,629,632,648,652,655,687,690,694,698,704,708,711,726,730,733,744,747,751,757,761,767],[237,238,150],"h1",{"id":239},"importing-files",[241,242,243,244,247],"p",{},"Gerbtrace imports files through the ",[245,246,26],"strong",{}," tab using drag-and-drop or the import button. This guide covers the import workflow, auto-detection behavior, and how to resolve mapping issues.",[249,250,252],"h2",{"id":251},"import-methods","Import methods",[254,255,257],"h3",{"id":256},"zip-packages","ZIP packages",[241,259,260],{},"Drop a ZIP file containing Gerber and drill files. Gerbtrace extracts all files and auto-classifies them by layer type. This is the fastest way to import a complete PCB design.",[254,262,264],{"id":263},"individual-files","Individual files",[241,266,267],{},"Drop or select individual files. You can import multiple files at once. Each file is classified independently.",[254,269,271],{"id":270},"supported-file-types","Supported file types",[273,274,275,288],"table",{},[276,277,278],"thead",{},[279,280,281,285],"tr",{},[282,283,284],"th",{},"Category",[282,286,287],{},"Extensions",[289,290,291,336,360,378,398],"tbody",{},[279,292,293,299],{},[294,295,296],"td",{},[245,297,298],{},"Gerber",[294,300,301,305,306,305,309,305,312,305,315,305,318,305,321,305,324,305,327,305,330,305,333],{},[302,303,304],"code",{},".gtl",", ",[302,307,308],{},".gbl",[302,310,311],{},".gts",[302,313,314],{},".gbs",[302,316,317],{},".gto",[302,319,320],{},".gbo",[302,322,323],{},".gtp",[302,325,326],{},".gbp",[302,328,329],{},".gm1",[302,331,332],{},".gko",[302,334,335],{},".gbr",[279,337,338,343],{},[294,339,340],{},[245,341,342],{},"Drill",[294,344,345,305,348,305,351,305,354,305,357],{},[302,346,347],{},".drl",[302,349,350],{},".drd",[302,352,353],{},".xln",[302,355,356],{},".exc",[302,358,359],{},".ncd",[279,361,362,367],{},[294,363,364],{},[245,365,366],{},"Pick and Place",[294,368,369,305,372,305,375],{},[302,370,371],{},".csv",[302,373,374],{},".tsv",[302,376,377],{},".txt",[279,379,380,384],{},[294,381,382],{},[245,383,50],{},[294,385,386,305,388,305,390,305,392,305,395],{},[302,387,371],{},[302,389,374],{},[302,391,377],{},[302,393,394],{},".xlsx",[302,396,397],{},".xls",[279,399,400,405],{},[294,401,402],{},[245,403,404],{},"Documents",[294,406,407],{},[302,408,409],{},".pdf",[241,411,412,413,416],{},"See ",[414,415,154],"a",{"href":155}," for detailed format specifications.",[249,418,420],{"id":419},"import-limits-and-recovery","Import limits and recovery",[241,422,423],{},"Imports are limited to 64 MiB per input file or extracted entry, 512 MiB of\nexpanded data per archive, and 10,000 entries. Folder traversal is limited to\n64 levels. These limits apply to actual expanded bytes, so compressed files\ncannot bypass them. An import failure appears in the Files panel; existing\nproject files and edited BOM rows remain available. Retry with a smaller batch\nor reload if a parsing worker failed.",[249,425,427],{"id":426},"auto-detection","Auto-detection",[254,429,431],{"id":430},"gerber-and-drill-files","Gerber and drill files",[241,433,434],{},"Layer types are detected from file names and extensions using common naming conventions:",[273,436,437,447],{},[276,438,439],{},[279,440,441,444],{},[282,442,443],{},"Pattern",[282,445,446],{},"Detected type",[289,448,449,461,473,485,497,509,521,533,545,557],{},[279,450,451,458],{},[294,452,453,305,455],{},[302,454,304],{},[302,456,457],{},"*top*copper*",[294,459,460],{},"Top copper",[279,462,463,470],{},[294,464,465,305,467],{},[302,466,308],{},[302,468,469],{},"*bottom*copper*",[294,471,472],{},"Bottom copper",[279,474,475,482],{},[294,476,477,305,479],{},[302,478,311],{},[302,480,481],{},"*top*mask*",[294,483,484],{},"Top solder mask",[279,486,487,494],{},[294,488,489,305,491],{},[302,490,314],{},[302,492,493],{},"*bottom*mask*",[294,495,496],{},"Bottom solder mask",[279,498,499,506],{},[294,500,501,305,503],{},[302,502,317],{},[302,504,505],{},"*top*silk*",[294,507,508],{},"Top silkscreen",[279,510,511,518],{},[294,512,513,305,515],{},[302,514,320],{},[302,516,517],{},"*bottom*silk*",[294,519,520],{},"Bottom silkscreen",[279,522,523,530],{},[294,524,525,305,527],{},[302,526,323],{},[302,528,529],{},"*top*paste*",[294,531,532],{},"Top solder paste",[279,534,535,542],{},[294,536,537,305,539],{},[302,538,326],{},[302,540,541],{},"*bottom*paste*",[294,543,544],{},"Bottom solder paste",[279,546,547,555],{},[294,548,549,305,551,305,553],{},[302,550,347],{},[302,552,353],{},[302,554,356],{},[294,556,342],{},[279,558,559,568],{},[294,560,561,305,563,305,565],{},[302,562,329],{},[302,564,332],{},[302,566,567],{},"*outline*",[294,569,570],{},"Board outline",[241,572,573,574,577],{},"Files that cannot be auto-classified appear as ",[245,575,576],{},"Unmatched"," and require manual assignment.",[254,579,581],{"id":580},"pnp-files","PnP files",[241,583,584,585,305,588,305,591,305,594,305,597,305,600,603,604,606],{},"PnP files are recognized by file name keywords (",[302,586,587],{},"pnp",[302,589,590],{},"pick",[302,592,593],{},"place",[302,595,596],{},"pos",[302,598,599],{},"xy",[302,601,602],{},"centroid","). Column mapping uses header text matching — see ",[414,605,42],{"href":43}," for details.",[254,608,610],{"id":609},"bom-files","BOM files",[241,612,613,614,305,617,305,620,603,623,625],{},"BOM files are recognized by name keywords (",[302,615,616],{},"bom",[302,618,619],{},"bill-of-materials",[302,621,622],{},"stückliste",[414,624,171],{"href":172}," for the full specification.",[254,627,404],{"id":628},"documents",[241,630,631],{},"PDF files are categorized by type. You can assign a document category after import:",[633,634,635,639,642,645],"ul",{},[636,637,638],"li",{},"Schematics",[636,640,641],{},"Drawings",[636,643,644],{},"Datasheets",[636,646,647],{},"Instructions",[249,649,651],{"id":650},"import-checks","Import checks",[241,653,654],{},"After import, Gerbtrace surfaces warnings when critical manufacturing data is missing or inconsistent:",[633,656,657,663,669,675,681],{},[636,658,659,662],{},[245,660,661],{},"No copper layer detected"," — the design has no copper layers",[636,664,665,668],{},[245,666,667],{},"No drill layer detected"," — no drill files were found",[636,670,671,674],{},[245,672,673],{},"No outline detected"," — no board outline or keep-out layer",[636,676,677,680],{},[245,678,679],{},"Only one outer copper side"," — only top or bottom copper present, not both",[636,682,683,686],{},[245,684,685],{},"Inner copper mismatch"," — configured layer count suggests inner copper layers that are not present",[241,688,689],{},"These checks are informational and should be resolved before production handover.",[249,691,693],{"id":692},"manual-mapping","Manual mapping",[254,695,697],{"id":696},"layer-type-assignment","Layer type assignment",[241,699,700,701,703],{},"If auto-detection assigns the wrong layer type, click the layer in the ",[245,702,26],{}," panel and select the correct type from the dropdown. Available types include all copper, mask, silk, paste, drill, and outline variants.",[254,705,707],{"id":706},"pnp-field-mapping","PnP field mapping",[241,709,710],{},"If PnP auto-detection fails, a mapping modal appears where you can:",[712,713,714,717,720,723],"ol",{},[636,715,716],{},"See a preview of the first data rows from your file.",[636,718,719],{},"Assign each required field (designator, X, Y, rotation) to a column.",[636,721,722],{},"Optionally map additional fields (side, value, package).",[636,724,725],{},"Configure the header row skip count.",[254,727,729],{"id":728},"bom-field-mapping","BOM field mapping",[241,731,732],{},"Similarly, if BOM auto-detection fails:",[712,734,735,738,741],{},[636,736,737],{},"Preview the file data.",[636,739,740],{},"Map fields (references, quantity, description, etc.) to columns.",[636,742,743],{},"Verify the mapping against the preview.",[241,745,746],{},"At least two columns must be successfully matched for auto-detection to succeed. Otherwise, the mapping dialog appears automatically.",[249,748,750],{"id":749},"file-preview","File preview",[241,752,753,754,756],{},"The ",[245,755,26],{}," panel includes a table preview for CSV\u002FTSV\u002FExcel files. Click any tabular file to see its contents in a data grid, which helps verify that the correct file was imported and the data looks reasonable before proceeding with mapping.",[249,758,760],{"id":759},"pdf-documents","PDF documents",[241,762,763,764,766],{},"Imported PDF files appear in the ",[245,765,5],{}," tab. Each document can be:",[633,768,769,772,775,778],{},[636,770,771],{},"Previewed inline",[636,773,774],{},"Downloaded",[636,776,777],{},"Categorized by type",[636,779,780],{},"Removed from the project",{"title":782,"searchDepth":783,"depth":784,"links":785},"",3,2,[786,791,792,798,799,804,805],{"id":251,"depth":784,"text":252,"children":787},[788,789,790],{"id":256,"depth":783,"text":257},{"id":263,"depth":783,"text":264},{"id":270,"depth":783,"text":271},{"id":419,"depth":784,"text":420},{"id":426,"depth":784,"text":427,"children":793},[794,795,796,797],{"id":430,"depth":783,"text":431},{"id":580,"depth":783,"text":581},{"id":609,"depth":783,"text":610},{"id":628,"depth":783,"text":404},{"id":650,"depth":784,"text":651},{"id":692,"depth":784,"text":693,"children":800},[801,802,803],{"id":696,"depth":783,"text":697},{"id":706,"depth":783,"text":707},{"id":728,"depth":783,"text":729},{"id":749,"depth":784,"text":750},{"id":759,"depth":784,"text":760},"How to import Gerber, drill, BOM, PnP, and document files with auto-detection and manual mapping.","md",null,{},true,{"title":150,"description":806},"PCO5fkSerdBDVwCvDs44IfqUvCT3kum1c-ilhlrYglk",[814,816],{"title":141,"path":142,"stem":143,"description":815,"children":-1},"Submit bug reports with optional email and description directly from within Gerbtrace.",{"title":154,"path":155,"stem":156,"description":817,"children":-1},"Complete list of file formats supported by Gerbtrace for Gerber, drill, BOM, PnP, and documents.",1790998747977]