Title: Kirki Customizer Framework Author: Themeum Published: May 27, 2014 Last modified: April 10, 2026 --- Search plugins ![](https://ps.w.org/kirki/assets/banner-772x250.jpg?rev=2947788) ![](https://ps.w.org/kirki/assets/icon-256x256.jpg?rev=2947788) # Kirki Customizer Framework By [Themeum](https://profiles.wordpress.org/themeum/) [Download](https://downloads.wordpress.org/plugin/kirki.5.2.3.zip) * [Details](https://li.wordpress.org/plugins/kirki/#description) * [Reviews](https://li.wordpress.org/plugins/kirki/#reviews) * [Installation](https://li.wordpress.org/plugins/kirki/#installation) * [Development](https://li.wordpress.org/plugins/kirki/#developers) [Support](https://wordpress.org/support/plugin/kirki/) ## Description [Kirki](https://github.com/themeum/kirki) is a Customizer toolkit for WordPress. An open-source initiative by [Themeum](https://github.com/themeum) for WordPress theme developers. Kirki allows you to build themes faster and more easily. With over 30 custom controls— ranging from simple sliders to advanced typography controls with Google Fonts integration— and features like automatic CSS generation and `postMessage` support, Kirki makes theme development a breeze. ### Features ✅ * Increased Performance * Simplified API * Automatic CSS Generation * Automatic postMessage Generation * Partial Refresh * Conditional Logic * GDPR Compliance * Improved Page Speed * And more! ### Controls 🎛️ * [Background Customizer Control](https://docs.themeum.com/kirki/controls/background/) * [Code Customizer Control](https://docs.themeum.com/kirki/controls/code/) * [Checkbox Customizer Control](https://docs.themeum.com/kirki/controls/checkbox/) * [Color Customizer Control](https://docs.themeum.com/kirki/controls/color/) * [Color Palette Customizer Control](https://docs.themeum.com/kirki/controls/color-palette/) * [Dashicons Customizer Control](https://docs.themeum.com/kirki/controls/dashicons/) * [Date Customizer Control](https://docs.themeum.com/kirki/controls/date/) * [Dimension Customizer Control](https://docs.themeum.com/kirki/controls/dimension/) * [Dimensions Customizer Control](https://docs.themeum.com/kirki/controls/dimensions/) * [Dropdown Pages Customizer Control](https://docs.themeum.com/kirki/controls/dropdown-pages/) * [Editor Customizer Control](https://docs.themeum.com/kirki/controls/editor/) * [Generic Customizer Control](https://docs.themeum.com/kirki/controls/generic/) * [Image Customizer Control](https://docs.themeum.com/kirki/controls/image/) * [Link Customizer Control](https://docs.themeum.com/kirki/controls/url/) * [Multiple Checkbox Customizer Control](https://docs.themeum.com/kirki/controls/multicheck/) * [Multicolor Customizer Control](https://docs.themeum.com/kirki/controls/multicolor/) * [Number Customizer Control](https://docs.themeum.com/kirki/controls/number/) * [Radio Customizer Control](https://docs.themeum.com/kirki/controls/radio/) * [Radio Buttonset Customizer Control](https://docs.themeum.com/kirki/controls/radio-buttonset/) * [Radio Image Customizer Control](https://docs.themeum.com/kirki/controls/radio-image/) * [Repeater Customizer Control](https://docs.themeum.com/kirki/controls/repeater/) * [Select Customizer Control](https://docs.themeum.com/kirki/controls/select/) * [Slider Customizer Control](https://docs.themeum.com/kirki/controls/slider/) * [Sortable Customizer Control](https://docs.themeum.com/kirki/controls/sortable/) * [Switch Customizer Control](https://docs.themeum.com/kirki/controls/switch/) * [Text Customizer Control](https://docs.themeum.com/kirki/controls/text/) * [Textarea Customizer Control](https://docs.themeum.com/kirki/controls/textarea/) * [Toggle Customizer Control](https://docs.themeum.com/kirki/controls/toggle/) * [Typography Customizer Control](https://docs.themeum.com/kirki/controls/typography/) * [Upload Customizer Control](https://docs.themeum.com/kirki/controls/upload/) * [Margin & Padding Controls](https://docs.themeum.com/kirki/extensions/margin-padding/) * [Headlines & Dividers](https://docs.themeum.com/kirki/extensions/headlines-dividers/) * [Responsive Controls](https://docs.themeum.com/kirki/extensions/responsive-controls/) * [Input Slider](https://docs.themeum.com/kirki/extensions/input-slider/) * [Tabs](https://docs.themeum.com/kirki/extensions/tabs/) ### Documentation 📖 You can find detailed documentation on how to use Kirki on https://www.themeum.com/ kirki/ ## Installation Simply install as a normal WordPress plugin and activate. If you want to integrate Kirki in your theme or plugin, please read the instructions on [our documentation site](https://docs.themeum.com/kirki/getting-started/integration/). ## Reviews ![](https://secure.gravatar.com/avatar/0290c377573fcaa2952a961d044397b7d9f4b4a7399261e475be28570d28066c? s=60&d=retro&r=g) ### 󠀁[Kirki – Good, but can break things](https://wordpress.org/support/topic/kirki-good-but-can-break-things/)󠁿 [dban](https://profiles.wordpress.org/dban/) April 11, 2026 1 reply Kirki is a powerful Customizer framework, but updates can cause serious compatibility issues. After updating to version 5.2.3, my site’s colors (Vice) completely broke and reverted to defaults, even though settings were unchanged. The issue was fixed only by downgrading to 5.1.1. If you use a theme that depends on Kirki: disable auto-updates and test before upgrading. Conclusion: Great tool, but updates are risky with existing themes. ![](https://secure.gravatar.com/avatar/7aeb42fcbb13f576901f0ee907ffc6e62d303ba954dfa323873dbae7e79bb5d8? s=60&d=retro&r=g) ### 󠀁[Version 5.1.1, no corresponding ChangeLog update.](https://wordpress.org/support/topic/version-5-1-1-no-corresponding-changelog-update/)󠁿 [48tibs](https://profiles.wordpress.org/48tibs/) December 2, 2025 I’d like to know the specific changes that are being applied to my website with each plugin update. It seams that the author forgot to add a corresponding changelog entry for the version 5.1.1 update. ![](https://secure.gravatar.com/avatar/4f202270f93ddf7eb5cb985382c22fdf79c577655a21a2cf4ccadf153d77c4cb? s=60&d=retro&r=g) ### 󠀁[Great plugin!](https://wordpress.org/support/topic/great-plugin-40745/)󠁿 [Irina](https://profiles.wordpress.org/irinashl/) August 13, 2025 Great plugin! ![](https://secure.gravatar.com/avatar/b00b810fd62cc1ac298145af1bbd93744a951e9d71e4761699069ed2fdda606a? s=60&d=retro&r=g) ### 󠀁[Slider Not working](https://wordpress.org/support/topic/slider-not-working-205/)󠁿 [dualaudi](https://profiles.wordpress.org/dualaudi/) January 27, 2024 I migrated a domain / new client that had kirki customizer slider – doesn’t look like it’s been working for quite some time. No updates to php/plugins/WP or otherwise was able to fix this issue – Finally found an archive . org version with the working slider and copied the HTML over to the WP template. Best of luck on future fixes. ![](https://secure.gravatar.com/avatar/d32c59c83c017545e78feb9c2c1bb2c434280ad7be3dde47da32aaa2bd0e4d96? s=60&d=retro&r=g) ### 󠀁[A lot of issues…](https://wordpress.org/support/topic/a-lot-of-issues-3/)󠁿 [Murat](https://profiles.wordpress.org/mdogancay/) September 8, 2023 For example after install this, u will get “Plugins added successfully. You may dismiss this notice now.” message on your admin panel and U CAN’T dismis it. Like a nightmare… ![](https://secure.gravatar.com/avatar/4ffdf659fc2175db9f3581d104ff29c360fc31409f626988c557ab94d21187b1? s=60&d=retro&r=g) ### 󠀁[Non optimized Plugin](https://wordpress.org/support/topic/non-optimized-plugin/)󠁿 [kerimonay](https://profiles.wordpress.org/kerimonay/) September 1, 2023 It is a poorly optimized plugin that puts a lot of load on the system. It only serves to adjust the page layout. After making your adjustments, remove it from your site. Install it again if you need it. Otherwise your site runs very slowly. [ Read all 79 reviews ](https://wordpress.org/support/plugin/kirki/reviews/) ## Contributors & Developers “Kirki Customizer Framework” is open source software. The following people have contributed to this plugin. Contributors * [ Themeum ](https://profiles.wordpress.org/themeum/) “Kirki Customizer Framework” has been translated into 23 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/kirki/contributors) for their contributions. [Translate “Kirki Customizer Framework” into your language.](https://translate.wordpress.org/projects/wp-plugins/kirki) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/kirki/), check out the [SVN repository](https://plugins.svn.wordpress.org/kirki/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/kirki/) by [RSS](https://plugins.trac.wordpress.org/log/kirki/?limit=100&mode=stop_on_copy&format=rss). ## Changelog = 5.2.3 – April 10, 2026 Update: Performance optimizations and random fixes. = 5.2.2 – February 17, 2026 Fix: Color palette not displaying in the Customizer in certain cases. Fix: Select field inside Repeater control not retaining the selected value. = 5.2.1 – February 10, 2026 Fix: Fixed an issue where the file path was used incorrectly. = 5.2.0 – February 09, 2026 Update: Performance optimizations across the platform. Update: Added compatibility with WordPress 6.9. = 5.1.0 – March 22, 2024 Fix: We’ve resolved the issue with fonts not loading properly, ensuring your designs look sleek and professional. Fix: Addressed deprecated errors to boost compatibility and keep your site running smoothly. Update: We’ve ensured compatibility with the latest WordPress 6.4 and PHP 8.2, so you can stay up-to-date with the latest technologies. = 5.0.0 – June 21, 2023 Update: Free and Pro merged = 4.2.0 – June 13, 2023 Fix:: Deprecated PHP issue Update: PHP 8.1 and 8.2 compatibility Update: WordPress latest (v6.2.2) compatibility = 4.1.1 – February 08, 2023 Update: Rename kirki packages dir & composer vendor-dir = 4.1.0 – February 07, 2023 New: Settings page to allow users to clear the Kirki font cache. Tweak: Bundled all individual packages into the main repository, reducing the number of repositories used in development. This simplifies development by eliminating the need to work on multiple repositories. ## Meta * Version **5.2.3** * Last updated **1 week ago** * Active installations **500,000+** * WordPress version ** 5.3 or higher ** * Tested up to **6.9.4** * PHP version ** 7.4 or higher ** * Languages * [Catalan](https://ca.wordpress.org/plugins/kirki/), [Chinese (China)](https://cn.wordpress.org/plugins/kirki/), [Czech](https://cs.wordpress.org/plugins/kirki/), [Danish](https://da.wordpress.org/plugins/kirki/), [Dutch](https://nl.wordpress.org/plugins/kirki/), [English (UK)](https://en-gb.wordpress.org/plugins/kirki/), [English (US)](https://wordpress.org/plugins/kirki/), [Galician](https://gl.wordpress.org/plugins/kirki/), [Greek](https://el.wordpress.org/plugins/kirki/), [Hindi](https://hi.wordpress.org/plugins/kirki/), [Italian](https://it.wordpress.org/plugins/kirki/), [Japanese](https://ja.wordpress.org/plugins/kirki/), [Norwegian (Bokmål)](https://nb.wordpress.org/plugins/kirki/), [Polish](https://pl.wordpress.org/plugins/kirki/), [Portuguese (Brazil)](https://br.wordpress.org/plugins/kirki/), [Russian](https://ru.wordpress.org/plugins/kirki/), [Slovak](https://sk.wordpress.org/plugins/kirki/), [Spanish (Chile)](https://cl.wordpress.org/plugins/kirki/), [Spanish (Colombia)](https://es-co.wordpress.org/plugins/kirki/), [Spanish (Spain)](https://es.wordpress.org/plugins/kirki/), [Spanish (Venezuela)](https://ve.wordpress.org/plugins/kirki/), [Swedish](https://sv.wordpress.org/plugins/kirki/), [Turkish](https://tr.wordpress.org/plugins/kirki/), and [Ukrainian](https://uk.wordpress.org/plugins/kirki/). * [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/kirki) * Tags * [customizer](https://li.wordpress.org/plugins/tags/customizer/)[options framework](https://li.wordpress.org/plugins/tags/options-framework/) [theme](https://li.wordpress.org/plugins/tags/theme/)[toolkit](https://li.wordpress.org/plugins/tags/toolkit/) * [Advanced View](https://li.wordpress.org/plugins/kirki/advanced/) ## Ratings 4.5 out of 5 stars. * [ 67 5-star reviews ](https://wordpress.org/support/plugin/kirki/reviews/?filter=5) * [ 1 4-star review ](https://wordpress.org/support/plugin/kirki/reviews/?filter=4) * [ 2 3-star reviews ](https://wordpress.org/support/plugin/kirki/reviews/?filter=3) * [ 2 2-star reviews ](https://wordpress.org/support/plugin/kirki/reviews/?filter=2) * [ 7 1-star reviews ](https://wordpress.org/support/plugin/kirki/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/kirki/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/kirki/reviews/) ## Contributors * [ Themeum ](https://profiles.wordpress.org/themeum/) ## Support Issues resolved in last two months: 0 out of 8 [View support forum](https://wordpress.org/support/plugin/kirki/)