Official KiCad 3D model libraries for rendering and MCAD integration
Clone or download
Misca1234 Merge pull request #456 from stambaughw/master
Add XP Power ISU02 series DC to DC converter model.
Latest commit 72bdb4c Nov 14, 2018
Failed to load latest commit information.
.github Update Dec 4, 2017
Battery.3dshapes separate the model in two parts, battery holder and battery Dec 8, 2017
Button_Switch_SMD.3dshapes Adding SW_SPST_PTS645 Aug 18, 2018
Button_Switch_THT.3dshapes Adding Adding NKK_BB15AH switch Aug 2, 2018
Buzzer_Beeper.3dshapes Added dimensions to filename to match footprint Oct 8, 2018
CMakeModules Restore CMake install capability lost in transition from kicad-library. Feb 10, 2018
Capacitor_SMD.3dshapes CP_Elec: fixed orientation, improved models, and added missing variat… Jun 26, 2018
Capacitor_THT.3dshapes Fix #255 for CP_Axial models. (Step models where alignd wrong.) Apr 20, 2018
Capacitor_Tantalum_SMD.3dshapes Newly exported 3d models for tantal caps. (new name, geometry check.) Dec 12, 2017
Connector.3dshapes Merge branch 'master' of in… Dec 13, 2017
Connector_BarrelJack.3dshapes Adding BarrelJack_CUI_PJ-063AH_Horizontal, BarrelJack_CUI_PJ-063BH_Ho… Jul 25, 2018
Connector_Card.3dshapes Adding microSD_HC_Hirose_DM3D-SF Aug 19, 2018
Connector_Coaxial.3dshapes added Molex MMCX 73415-0961 Sep 9, 2018
Connector_FFC-FPC.3dshapes reexported 502250 with correct name and removed FCstd Jun 19, 2018
Connector_IDC.3dshapes Newly exported IDC models (new name, geometry check) Dec 8, 2017
Connector_JST.3dshapes Newly generated jst 3d models Dec 6, 2017
Connector_Molex.3dshapes Add -1MP to picoblade filenames Jun 18, 2018
Connector_Phoenix_GMSTB.3dshapes Split phoenix mstb series connectors acourding to voltage rating. May 3, 2018
Connector_Phoenix_MC.3dshapes Split phoenix mc series connectors acourding to voltage rating. May 3, 2018
Connector_Phoenix_MC_HighVoltage.3dshapes Split phoenix mc series connectors acourding to voltage rating. May 3, 2018
Connector_Phoenix_MSTB.3dshapes Split phoenix mstb series connectors acourding to voltage rating. May 3, 2018
Connector_Pin.3dshapes Rename to D Feb 1, 2018
Connector_PinHeader_1.00mm.3dshapes renamed to Connector Dec 12, 2017
Connector_PinHeader_1.27mm.3dshapes renamed to Connector Dec 12, 2017
Connector_PinHeader_2.00mm.3dshapes renamed to Connector Dec 12, 2017
Connector_PinHeader_2.54mm.3dshapes renamed to Connector Dec 12, 2017
Connector_PinSocket_1.00mm.3dshapes Renamed Conn_ to Connector_ Nov 29, 2017
Connector_PinSocket_1.27mm.3dshapes Renamed Conn_ to Connector_ Nov 29, 2017
Connector_PinSocket_2.00mm.3dshapes Renamed Conn_ to Connector_ Nov 29, 2017
Connector_PinSocket_2.54mm.3dshapes Renamed Conn_ to Connector_ Nov 29, 2017
Connector_RJ.3dshapes Adding RJ45_Amphenol_RJHSE538X Aug 18, 2018
Connector_Samtec.3dshapes Fixing pitch and some dimensions Jul 24, 2018
Connector_USB.3dshapes Re-export Molex 47346 micro USB model May 26, 2018
Converter_ACDC.3dshapes Merge pull request #407 from Cylindric/rac04 Sep 27, 2018
Converter_DCDC.3dshapes Add XP Power ISU02 series DC to DC converter model. Nov 9, 2018
Crystal.3dshapes Added Crystal_SMD_SeikoEpson_MA40X Oct 28, 2018
Diode_SMD.3dshapes Rename some wrongly named 3d models Jan 27, 2018
Diode_THT.3dshapes added SOD-70 and some SOD-68 3D models Apr 28, 2018
Display.3dshapes Merge pull request #253 from strombom/RC1602A-fix-pins Apr 4, 2018
Display_7Segment.3dshapes Hdsp led (#276) Oct 22, 2018
Fuse.3dshapes rename to match footprints-repo Jan 8, 2018
Inductor_SMD.3dshapes Added Source code for TDK SLF serie of inductiors Oct 18, 2018
Inductor_THT.3dshapes Remove old 3d models for IHA series inductors with wrong pin pitch Apr 29, 2018
LED_SMD.3dshapes added the normal SMD LED's Mar 14, 2018
LED_THT.3dshapes Added 3D models for LED_VCCLite 5381H serie Oct 24, 2018
OptoDevice.3dshapes JST connector name replaced with Sharp_GP2Y0A41SK0F in .step file. Sep 22, 2018
Oscillator.3dshapes readded/reexported several pre-existing 3D models Jan 8, 2018
Package_BGA.3dshapes Added script based BGA models Oct 26, 2018
Package_DFN_QFN.3dshapes Added 103 auto generated models Nov 2, 2018
Package_DIP.3dshapes Added 75 auto generated DIP 2D models Nov 4, 2018
Package_DirectFET.3dshapes fixed fusion for STEP model Oct 17, 2017
Package_LGA.3dshapes Added 11 auto created QFN(LGA) 3D models Nov 4, 2018
Package_QFP.3dshapes Rename 3d models with ep to fit the new footprint names Jan 26, 2018
Package_SO.3dshapes Modified TSOP-I-32_11.8x8mm_P0.5mm and TSOP-II-54_22.2x10.16mm_P0.8mm Nov 13, 2018
Package_SON.3dshapes Renamed Oct 12, 2018
Package_TO_SOT_SMD.3dshapes Chaned to Texas_ inside the file Nov 7, 2018
Package_TO_SOT_THT.3dshapes Update all staggered to-sot 3d models names to new naming convention May 7, 2018
Potentiometer_THT.3dshapes Manually recreated Oct 28, 2018
RF_Module.3dshapes Merge pull request #282 from true-nature/mw_twelite Oct 4, 2018
Relay_SMD.3dshapes added several more Omron relays and an Axicom IM Jleg 3D model Jan 14, 2018
Relay_THT.3dshapes Fixed incorrect height Sep 30, 2018
Resistor_SMD.3dshapes Merge pull request #390 from penoud/LVK25 Sep 6, 2018
Resistor_THT.3dshapes removed misplaced models Jan 11, 2018
Sensor_Audio.3dshapes 3D models exported with StepUp Jan 29, 2018
Sensor_Current.3dshapes Merge pull request #272 from Misca1234/LEM_LA25-P Jul 4, 2018
Sensors.3dshapes Added credits file to Sensors. Apr 23, 2017
TestPoint.3dshapes readded/reexported several pre-existing 3D models Jan 8, 2018
Transformer_SMD.3dshapes Adding Transformer_Ethernet_HALO_TG111-MSC13 Jul 14, 2018
Valve.3dshapes readded/reexported several pre-existing 3D models Jan 8, 2018
Vrml_materials_doc adding Vrml material & illumination reference doc Aug 10, 2018
.gitattributes Create .gitattributes Feb 28, 2017
.gitignore Create .gitignore Feb 28, 2017
CMakeLists.txt Prevent recursion when building and installing from source path. Apr 26, 2018 CREDITS splitted into folders :) Mar 14, 2017 Update Sep 26, 2017 adding to the repo the Vrml material docs Aug 10, 2018 [enh] updated credits and todo file Jun 10, 2017

KiCad 3D Models

This repository contains 3D models for rendering and MCAD integration, for use with KiCAD EDA software. The model needs a mechanical model source (a manually-modelled or script-generated file); its WRL counterpart file must be obtained as a conversion from the MCAD model

Supported File Formats

The 3D model library supports two file formats:


STEP files are used for integration with MCAD software packages.
STEP models must be 1:1 in mm, better if the model is a solid single object (a union of parts) for size and loading optimization. KiCad supports STEP file integration and can export board and component models into an integrated STEP file. This file can then be imported by a MCAD package.


WRL files must be exported from its mechanical model counterpart. WRL files are used for photo-realistic rendering using KiCad's raytracing rendering engine. This format supports more complex material properties, allowing various common component materials to be accurately rendered.

Source Files

Source files for generated models should be submitted to ( This includes generator scripts, or native model files from source software (e.g. FreeCAD)

Preferred method to create 3D models

The model has to be created in a mechanical program, able to generate STEP export. The model can be created by automatic scripts or manually. FreeCAD is the preferred software because it is open source, and anyone can rework the model for future improvements, but also other proprietary MCAD software are allowed. In case the model is generated by scripts, the scripts should be linked to the PR stating sw and version used to run the scripts; when the model is manually created, the MCAD source file should be added to the PR as well as STEP file. STEP models should be 1:1 in mm, better if the model is a solid single object (a union of parts) for size and loading optimization; text is not suggested on models because of size increasing, anyway in case of text the fonts must be licensed free as the word. WRL models should be exported from its mechanical counterpart and, when possible, have the suggested material properties as in these documents:

A simple method to export a fully compliant WRL model from a mechanical STEP model is through KiCad StepUp.
A tutorial video can be found here
A good starting point to learn how to create models by script is this github repo kicad-3d-models-in-freecad.
The scripts are made in Python and run in FreeCAD with CadQuery module add-on.

Model Alignment

The 3D models in this library are aligned with the footprints available in the KiCad footprint libraries.

Model Scaling

  • The STEP file format includes model scaling information, and so the 3D model scaling parameter must always be set to 1:1 in mm
  • The WRL file format does not specify absolute dimensions. KiCad normalizes WRL model dimension to units of 0.1 Inches, and the internal units of the WRL files should be scaled accordingly


Refer to the Wiki page on Contributing

Model Licencing

Refer to the file

External Model Libraries

In addition to the 3D model data provided in this library, there are other sources that designers may use to source 3D models.

Ensure that the LICENSE of any 3D data used is compatible with the intended use-case of the project.