PHPackages                             aristath/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. [Utility &amp; Helpers](/categories/utility)
4. /
5. aristath/kirki

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

aristath/kirki
==============

Extending the WordPress customizer

4.2.0(3y ago)1.3k73.1k↓73.8%324[114 issues](https://github.com/themeum/kirki/issues)[5 PRs](https://github.com/themeum/kirki/pulls)4MITPHPPHP &gt;=7.0CI failing

Since Mar 30Pushed 2mo ago63 watchersCompare

[ Source](https://github.com/themeum/kirki)[ Packagist](https://packagist.org/packages/aristath/kirki)[ Docs](https://kirki.org)[ RSS](/packages/aristath-kirki/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (10)Dependencies (5)Versions (141)Used By (4)

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 &amp; more easily.

With over **30 custom controls** ranging from simple sliders to complex typography controls with Google-Fonts integration and features like automatic CSS &amp; `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
- &amp; 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

58

—

FairBetter than 98% of packages

Maintenance54

Moderate activity, may be stable

Popularity53

Moderate usage in the ecosystem

Community41

Growing community involvement

Maturity76

Established project with proven stability

 Bus Factor1

Top contributor holds 84.7% 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

1123d 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 &gt;=5.3

1.0.0-beta1PHP &gt;=5.2

v4.0-beta.1PHP &gt;=5.6

v4.0PHP &gt;=7.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/471c510b2590bce99d5e41cc9b817f0c0d420f08d0930e70b18299f993ffa965?d=identicon)[aristath](/maintainers/aristath)

---

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)")[![saadman30](https://avatars.githubusercontent.com/u/140490543?v=4)](https://github.com/saadman30 "saadman30 (62 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)")[![shewa12](https://avatars.githubusercontent.com/u/30765517?v=4)](https://github.com/shewa12 "shewa12 (33 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)")[![vpratfr](https://avatars.githubusercontent.com/u/2526465?v=4)](https://github.com/vpratfr "vpratfr (13 commits)")[![scrutinizer-auto-fixer](https://avatars.githubusercontent.com/u/6253494?v=4)](https://github.com/scrutinizer-auto-fixer "scrutinizer-auto-fixer (13 commits)")[![mintbird](https://avatars.githubusercontent.com/u/695425?v=4)](https://github.com/mintbird "mintbird (8 commits)")[![naxvog](https://avatars.githubusercontent.com/u/4963183?v=4)](https://github.com/naxvog "naxvog (7 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)")[![mohdsayed](https://avatars.githubusercontent.com/u/6297436?v=4)](https://github.com/mohdsayed "mohdsayed (6 commits)")

---

Tags

customizerkirkiplugintheme-developmenttoolkitwordpresswordpress-customizerwordpress-pluginwordpress-theme-developmentwordpresscustomizer

### Embed Badge

![Health badge](/badges/aristath-kirki/health.svg)

```
[![Health](https://phpackages.com/badges/aristath-kirki/health.svg)](https://phpackages.com/packages/aristath-kirki)
```

###  Alternatives

[afragen/git-updater

A plugin to automatically update GitHub, Bitbucket, GitLab, or Gitea hosted plugins, themes, and language packs.

3.3k1.7k](/packages/afragen-git-updater)[proteusthemes/wp-customizer-utilities

Advanced WordPress customizer controls and settings for better user experience.

329.9k1](/packages/proteusthemes-wp-customizer-utilities)[tacowordpress/tacowordpress

WordPress custom post types that feel like CRUD models

232.2k](/packages/tacowordpress-tacowordpress)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
