PHPackages kirki-framework/kirki - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Framework](/categories/framework) 4. / 5. kirki-framework/kirki ActiveLibrary[Framework](/categories/framework) kirki-framework/kirki ===================== Extending the WordPress customizer 4.2.0(2y ago)1.3k2.9k327[112 issues](https://github.com/themeum/kirki/issues)[1 PRs](https://github.com/themeum/kirki/pulls)MITPHPPHP >=7.0CI failing Since Mar 30Pushed 3mo ago63 watchersCompare [ Source](https://github.com/themeum/kirki)[ Packagist](https://packagist.org/packages/kirki-framework/kirki)[ Docs](https://kirki.org)[ RSS](/packages/kirki-framework-kirki/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (5)Versions (137)Used By (0) Kirki Customizer Framework ========================== [](#kirki-customizer-framework) **Contributors:** \[themeum\] **Tags:** customizer, options framework, theme, mods, toolkit, gutenberg **Requires at least:** 5.2 **Tested up to:** 6.8.3 **Stable tag:** 5.1.1 **License:** MIT **License URI:** The ultimate customizer framework for WordPress theme developers. Description ----------- [](#description) [![Build Status](https://camo.githubusercontent.com/069ab62cd69c73627a465118be08d223e29cd4deb0affe13a259227eb1029522/68747470733a2f2f7472617669732d63692e6f72672f61726973746174682f6b69726b692e7376673f6272616e63683d646576656c6f70)](https://travis-ci.org/aristath/kirki) [![Code Climate](https://camo.githubusercontent.com/0dc8e76bd5377ea81214e5c350830d455f4fae471ee95adda55c455646d12761/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f61726973746174682f6b69726b692f6261646765732f6770612e737667)](https://codeclimate.com/github/aristath/kirki) [![License: MIT](https://camo.githubusercontent.com/fdf2982b9f5d7489dcf44570e714e3a15fce6253e0cc6b5aa61a075aac2ff71b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f772e737667)](https://opensource.org/licenses/MIT) [![Codacy Badge](https://camo.githubusercontent.com/b45d85b3e66b31d429b774396560f4a2962be97c743333613b117da643d873da/68747470733a2f2f6170692e636f646163792e636f6d2f70726f6a6563742f62616467652f47726164652f3636643664386236613436353463643138363836656431636439663162666233)](https://www.codacy.com/app/aristath/kirki?utm_source=github.com&utm_medium=referral&utm_content=aristath/kirki&utm_campaign=Badge_Grade) [![Scrutinizer Code Quality](https://camo.githubusercontent.com/3866c4d15776feb6fc455614034a22db93fe459aa482b2aef44de80c4f6d90bd/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f61726973746174682f6b69726b692f6261646765732f7175616c6974792d73636f72652e706e673f623d646576656c6f70)](https://scrutinizer-ci.com/g/aristath/kirki/?branch=develop) [Kirki](https://www.themeum.com/kirki/) allows theme developers to build themes quicker & more easily. With over **30 custom controls** ranging from simple sliders to complex typography controls with Google-Fonts integration and features like automatic CSS & `postMessage` script generation, Kirki makes theme development a breeze. ### Features [](#features) - Increased Performance - Simplified API - Automatic CSS Generation - Automatic postMessage Generation - Partial Refresh - Conditional Logic - GDPR Compliance - Improved Page Speed - & more! ### Controls [](#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/) ### Documentation [](#documentation) You can find detailed documentation on how to use Kirki on [themeum.com](https://www.themeum.com/kirki/) ### Disclaimer [](#disclaimer) Theme developers should be familiar with the Customizer API before starting to build a theme using Kirki. An excellent handbook for the WordPress Customizer can be found on the [developer.wordpress.org](https://developer.wordpress.org/themes/customize-api/) website. Installation ------------ [](#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/). Changelog --------- [](#changelog) [See the previous changelogs here](https://github.com/kirki-framework/kirki/blob/master/CHANGELOG.md). ### Health Score 56 — FairBetter than 98% of packages Maintenance53 Moderate activity, may be stable Popularity46 Moderate usage in the ecosystem Community38 Small or concentrated contributor base Maturity76 Established project with proven stability Bus Factor1 Top contributor holds 86.2% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~23 days Recently: every ~118 days Total 127 Last Release 1077d ago Major Versions 0.8.4 → 1.0.0-beta12015-06-20 1.0.2 → 2.0-alpha.201511222015-11-22 2.4.0-beta.2 → 3.0.0-beta.22017-05-28 2.3.8 → 3.0.02017-06-22 3.1.9 → v4.0-beta.12021-10-14 PHP version history (4 changes)0.8.0PHP >=5.3 1.0.0-beta1PHP >=5.2 v4.0-beta.1PHP >=5.6 v4.0PHP >=7.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/e0d7302368a3ac90da1ea4d751d360751d17fefc2339230b99745f7eaccd8162?d=identicon)[MapSteps](/maintainers/MapSteps) ![](https://www.gravatar.com/avatar/8ea86140b2433e1286413b80af9e79aa983d318643851994f33a48fbd4faa695?d=identicon)[contactjavas](/maintainers/contactjavas) ![](https://www.gravatar.com/avatar/ab5ad286fbf66da75489e9749456aefc532505ae5c3a44f03f1f17eb4394e6c2?d=identicon)[Themeum](/maintainers/Themeum) --- Top Contributors [![aristath](https://avatars.githubusercontent.com/u/588688?v=4)](https://github.com/aristath "aristath (4559 commits)")[![contactjavas](https://avatars.githubusercontent.com/u/25834188?v=4)](https://github.com/contactjavas "contactjavas (319 commits)")[![DannyCooper](https://avatars.githubusercontent.com/u/152804?v=4)](https://github.com/DannyCooper "DannyCooper (64 commits)")[![guillaumemolter](https://avatars.githubusercontent.com/u/1478527?v=4)](https://github.com/guillaumemolter "guillaumemolter (59 commits)")[![rinkuyadav999](https://avatars.githubusercontent.com/u/9743287?v=4)](https://github.com/rinkuyadav999 "rinkuyadav999 (39 commits)")[![fovoc](https://avatars.githubusercontent.com/u/2421981?v=4)](https://github.com/fovoc "fovoc (36 commits)")[![igmoweb](https://avatars.githubusercontent.com/u/1516569?v=4)](https://github.com/igmoweb "igmoweb (28 commits)")[![mapsteps](https://avatars.githubusercontent.com/u/22119831?v=4)](https://github.com/mapsteps "mapsteps (24 commits)")[![wprashed](https://avatars.githubusercontent.com/u/16035337?v=4)](https://github.com/wprashed "wprashed (20 commits)")[![ibrahim-kardi](https://avatars.githubusercontent.com/u/25303964?v=4)](https://github.com/ibrahim-kardi "ibrahim-kardi (17 commits)")[![margolisj](https://avatars.githubusercontent.com/u/1588194?v=4)](https://github.com/margolisj "margolisj (15 commits)")[![scrutinizer-auto-fixer](https://avatars.githubusercontent.com/u/6253494?v=4)](https://github.com/scrutinizer-auto-fixer "scrutinizer-auto-fixer (13 commits)")[![vpratfr](https://avatars.githubusercontent.com/u/2526465?v=4)](https://github.com/vpratfr "vpratfr (13 commits)")[![mintbird](https://avatars.githubusercontent.com/u/695425?v=4)](https://github.com/mintbird "mintbird (8 commits)")[![jrfnl](https://avatars.githubusercontent.com/u/663378?v=4)](https://github.com/jrfnl "jrfnl (7 commits)")[![briancwelch](https://avatars.githubusercontent.com/u/3002855?v=4)](https://github.com/briancwelch "briancwelch (7 commits)")[![naxvog](https://avatars.githubusercontent.com/u/4963183?v=4)](https://github.com/naxvog "naxvog (7 commits)")[![mohdsayed](https://avatars.githubusercontent.com/u/6297436?v=4)](https://github.com/mohdsayed "mohdsayed (6 commits)")[![timelsass](https://avatars.githubusercontent.com/u/11907254?v=4)](https://github.com/timelsass "timelsass (6 commits)")[![AlxMedia](https://avatars.githubusercontent.com/u/6096719?v=4)](https://github.com/AlxMedia "AlxMedia (5 commits)") --- Tags customizerkirkiplugintheme-developmenttoolkitwordpresswordpress-customizerwordpress-pluginwordpress-theme-developmentwordpresscustomizer ### Embed Badge ![Health badge](/badges/kirki-framework-kirki/health.svg) ``` [![Health](https://phpackages.com/badges/kirki-framework-kirki/health.svg)](https://phpackages.com/packages/kirki-framework-kirki) ``` ### Alternatives [redux-framework/redux-framework Build better and beautiful sites in WordPress, faster. 1.8k6.2k](/packages/redux-framework-redux-framework) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)