KiCon 2024 in Asia is coming in November!
Get your tickets now to join the largest KiCad conference ever.

Report an Issue

The easiest way to report an issue with the KiCad application is to select HelpReport Bug. This will open your web browser to the KiCad issue tracker and begin creating a new report. The report will automatically contain the required version info from your installation of KiCad. You will need to write a description of your issue and how to reproduce it yourself.

You can also create a new issue by hand. Select the appropriate location from the blue buttons below. Once you are on the issue tracker, click on the New Issue button.

No matter how the issue is created, you will see a prefilled issue form, formatted using markdown syntax. This image shows a good report that provides full information:

Example of good report
Important Program version must be copied by clicking on the Copy Version Info button, found under HelpAbout, and pasted into the issue form under section # KiCad Version. If you use HelpReport Bug, this step is done for you.

For Command Line Interface reports, generate the version info using:
kicad-cli version --format about

Reporting Locations

KiCad (applications)

If you have a functional issue with using any application, such as the project launcher (KiCad), schematic editor (Eeschema), PCB editor (Pcbnew), Gerber viewer (gerbview), or other executables.

Translations (for the applications)

KiCad applications by default have all of their interface text written in English. A group of contributors creates special translation files to convert the English text to other languages.

Documentation (any language)

All the documentation is made up a team of contributors that spend their time painstakingly keeping content up to date with KiCad’s changes. Additionally contributors also spend time translating the same manuals into other languages.

Website

The website is maintained by another group of maintainers. The main website at kicad.org is separate from the documentation website docs.kicad.org. Please report any issues in the correct location.

Support/Help Requests

Issue trackers are not for general support requests asking how do you use or do something in KiCad.

We ask you instead look at the community forums links for communities that can provide help.