We will learn how to create custom symbol and custom symbol library in KiCad v5.
KiCad has a separate library for schematic symbols and footprints. The only place that a linkage between these libraries occurs – your project. In the Schematic Layout Editor, you can define a footprint to associate with a schematic symbol, or component.
Tag: Project 135n Creating custom symbol and custom symbol library in KiCad v5. Acoptex.lt
Project resources
- Sketch: None;
- Libraries: None.
What is Symbol Library?
A symbol library consists of three files with extensions .dcm, .lib, and .bck. KiCad creates the .bck automatically. In case you make unintended changes to your library file, you can roll-back to the previous version. The .dcm file contains metadata for the library’s symbols. The .lib file contains all of the schematic symbols as a “library”. By the way, the file format is plain text, so you can quickly view or edit it. Within your project folder, KiCad creates a file called “-cache.lib.” It keeps all of the symbols used in a schematic. With this file, any PC can open the schematic. The KiCad schematic symbol library and the cache is a single file.


What is footprint library?
Footprints are text files that have a .mod_kicad extension. A directory of these files makes up a Footprint library. The directory name has the .pretty extension. If you see KiCad files with the .mod extension, those are legacy footprints. Since there is one footprint per file, it is possible to have multiple footprints for the same component. There is no native linkage between a schematic symbol and a footprint in KiCad. The schematic (or circuit board) design makes that link. To create your own library of parts, you need to create two libraries: one for schematics and one for footprints. KiCad has a big library of standard footprints that are easy to match up to a custom symbol.
Step by Step instruction
1.Creating a new custom symbol library
- But before creating a symbol we need to create a new KiCad library. We assume that you have the KiCad v5 already installed. Double-click on the KiCad shortcut to start the program.

2. You will see KiCad project manager window opened. Go to Tools -> Edit Schematic Symbols or press Ctrl+L on your keyboard of click on Symbol Editor button.

3. Go to File -> New Library… Creating your library keeps your custom symbols in one place. These can be symbols you create or download.

4. Navigate to the folder where you would like to save your library, give it a name and click on Save button.

5.The Add to Library Table window pops up. You have two options: Global or Project to choose from and you need to tell KiCad if you want to keep this library specific to the current project or if you want it available globally. Global means that all projects can access it and this library will be added in the predefined libraries which already exist in KiCad. Select Global and click on OK button.

6. The library My_library.lib is created. Please note that if you already created a schematic library file, you can go to File -> Add Library and then select Global or Project.

2.Creating a new symbol
- Go to File -> New Symbol… or press Ctrl+N on your keyboard or click on Create new symbol icon.


2. Select My_library and click on OK button.

3. You will be asked for a symbol name (this name is used as default value for the value field in the schematic editor), the reference designator (U, IC, R…), the number of units per package (for example a 7400 is made of 4 units per package) and if an alternate body style (sometimes referred to as DeMorgan) is desired. If the reference designator field is left empty, it will default to “U”. These properties can be changed later, but it is preferable to set them correctly at the creation of the symbol. Let’s name our symbol BMP180, leave the reference as U and click on OK button.

4. You can now see BMP180, which is the name of your symbol, and U, which is the reference designator. Make sure the name and reference designator are in an appropriate place. You can put the reference designator at the upper-left hand corner and the name field at the lower-right hand or use your way to do it. Right-click on the screen, you will see an option called Grid. It’s best to keep it to 50.00 mils.

5. Click on Add graphic rectangle to symbol body icon and draw a rectangle.


6. Let’s fill in the background of this rectangle. There are two different ways to do that:
- Place your cursor on the rectangle line, then right-click with mouse on it. Select Edit Rectangle Options. The Rectangle Drawing Properties window pops up. Select Fill with body background color setting and click on OK button.
- Place your cursor on the rectangle line, then press E on your keyboard. The Rectangle Drawing Properties window pops up. Select Fill with body background color setting and click on OK button.



7. Let’s place the pins. Click on Add pins to symbol icon. Place the cursor where you want to create the pin and click with mouse. The Pin Properties window pops up. KiCad gives you many attributes to describe a pin, but there are main requirements: a pin name, a pin number and a pin orientation. The name should be descriptive. If you use the tilde (~) character, KiCad adds a bar above the name. This mark is useful for inverted or active-low signals. If your symbol has multiple package styles, you need to create a different symbol for each style to match up the pins’ numbers. The orientation lets you place pins on all of the sides of a symbol. After exiting the Pin Properties window, if you need to change the pin’s orientation, use the R on your keyboard. One optional element is the pin’s function. You can define the function as input, output, power, and several others. This extra information is used when running the Electrical Rule Check (ERC). It tries to detect schematics with short circuits.


6. As we are trying to make BMP180 symbol we need 4 or 5 pins, the BMP180 we will use has 5 pins because of 3.3V converter. Set the pin name, number, electrical type, graphical type, orientation and click on OK button. Repeat the same action for other pins. Once the pins are placed, right-click with your mouse on the screen and select End Tool.







There are different ways to lay out the pins:

- Pin Order. This method is similar to setting up the schematic as the IC or component appears.
- Schematic Order. It’s a good way when you add the inductors, capacitors, and resistors as you can see a nice clean schematic.
- Schematic Order. It’s a good way when you add the inductors, capacitors, and resistors as you can see a nice clean schematic.
7. You can see the pins are placed and the names are given. Our custom symbol is completed and you can save it now. Click on Save all changes icon. Remember your library name – My_Library and the symbol name – BMP180.

3. How to give description to a custom symbol
- Select your custom symbol in the custom library. Go to Edit -> Properties…

2. Type your description and keywords and click on OK button. You can also change fields data and other options here.

4. How to give description to a custom symbol library
- Go to Preferences -> Manage Symbol Libraries… Find your library and type description. Click on OK button. Restart the Symbol Editor tool.



Wrapping up
We have learnt how to create custom symbol and custom schematic symbol library in KiCad v5.
Check out our article about Printed circuit board and terms used in connection with PCB design and manufacturing
Thank you for reading and supporting us.
Check for more DIY projects on Acoptex.lt and Acoptex.com!
If you are looking for high quality PCBs PCBWay is the best choice:

RELATED POSTS
Printed circuit board and terms used in connection with design and manufacturing
How to plot schematic to PDF, SVG, DXF, HPGL and postscript formats in KiCad
How to read netlist to add footprints and where to find the footprint mode in KiCad v5