PHPackages                             sylius/promotion - 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. sylius/promotion

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

sylius/promotion
================

Flexible promotion management for PHP applications.

v2.2.4(3mo ago)28477.8k↓25.2%197MITPHPPHP ^8.2

Since Jun 2Pushed 2mo ago16 watchersCompare

[ Source](https://github.com/Sylius/Promotion)[ Packagist](https://packagist.org/packages/sylius/promotion)[ Docs](https://sylius.com)[ GitHub Sponsors](https://github.com/sylius)[ RSS](/packages/sylius-promotion/feed)WikiDiscussions master-old Synced 1mo ago

READMEChangelogDependencies (10)Versions (314)Used By (7)

Promotion Component
===================

[](#promotion-component)

Almost every e-commerce project needs strong tools for marketing campaigns.

The system we developed for Sylius has a very rich feature set, including:

- Time based promotions
- Fixed and percentage discounts
- Support for custom actions, which gives unlimited flexibility
- Rules system, which allows to apply promotions in very specific cases
- Promotion coupons with usage limits

Sylius
------

[](#sylius)

 [    ![Sylius Logo.](https://camo.githubusercontent.com/ea9dddc934264aa7ec01cf3202c500f3d8b04448bce2571bdc74230efddda88f/68747470733a2f2f6d656469612e73796c6975732e636f6d2f73796c6975732d6c6f676f2d3830302e706e67)  ](https://sylius.com)

Sylius is an Open Source eCommerce solution built from decoupled components with powerful API and the highest quality code. [Read more on sylius.com](https://sylius.com).

Documentation
-------------

[](#documentation)

Documentation is available on [**docs.sylius.com**](https://docs.sylius.com/en/latest/components_and_bundles/components/Promotion/index.html).

Contributing
------------

[](#contributing)

[This page](https://docs.sylius.com/en/latest/contributing/index.html) contains all the information about contributing to Sylius.

Follow Sylius' Development
--------------------------

[](#follow-sylius-development)

If you want to keep up with the updates and latest features, follow us on the following channels:

- [Official Blog](https://sylius.com/blog)
- [Sylius on Twitter](https://twitter.com/Sylius)
- [Sylius on Facebook](https://facebook.com/SyliusEcommerce)

Bug tracking
------------

[](#bug-tracking)

Sylius uses [GitHub issues](https://github.com/Sylius/Sylius/issues). If you have found bug, please create an issue.

MIT License
-----------

[](#mit-license)

License can be found [here](https://github.com/Sylius/Sylius/blob/master/LICENSE).

Authors
-------

[](#authors)

The component was originally created by [Paweł Jędrzejewski](https://pjedrzejewski.com). See the list of [contributors](https://github.com/Sylius/Promotion/contributors).

###  Health Score

69

—

FairBetter than 100% of packages

Maintenance83

Actively maintained with recent releases

Popularity48

Moderate usage in the ecosystem

Community37

Small or concentrated contributor base

Maturity95

Battle-tested with a long release history

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~14 days

Recently: every ~0 days

Total

311

Last Release

118d ago

Major Versions

v0.19.0 → v1.0.0-alpha.12016-10-20

v1.14.0-ALPHA.2 → v2.0.0-ALPHA.12024-09-18

v1.14.0 → v2.0.0-RC.12024-10-22

v1.14.18 → v2.1.122026-01-20

PHP version history (10 changes)v0.10.0PHP &gt;=5.3.3

v0.16.0PHP ^5.5.9|^7.0

v0.19.0PHP ^5.6|^7.0

v1.0.0-rc.2PHP ^7.1

v1.3.0-BETAPHP ^7.2

v1.7.0-RC.1PHP ^7.3

v1.10.0-ALPHA.1PHP ^7.4 || ^8.0

v1.11.4PHP ^8.0

v1.13.0-BETA.1PHP ^8.1

v2.0.0-ALPHA.1PHP ^8.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/719423?v=4)[Sylius eCommerce](/maintainers/sylius)[@Sylius](https://github.com/Sylius)

---

Top Contributors

[![pamil](https://avatars.githubusercontent.com/u/1897953?v=4)](https://github.com/pamil "pamil (120 commits)")[![Zales0123](https://avatars.githubusercontent.com/u/6212718?v=4)](https://github.com/Zales0123 "Zales0123 (50 commits)")[![pjedrzejewski](https://avatars.githubusercontent.com/u/614970?v=4)](https://github.com/pjedrzejewski "pjedrzejewski (17 commits)")[![lchrusciel](https://avatars.githubusercontent.com/u/6213903?v=4)](https://github.com/lchrusciel "lchrusciel (16 commits)")[![stloyd](https://avatars.githubusercontent.com/u/67402?v=4)](https://github.com/stloyd "stloyd (15 commits)")[![GSadee](https://avatars.githubusercontent.com/u/6140884?v=4)](https://github.com/GSadee "GSadee (14 commits)")[![umpirsky](https://avatars.githubusercontent.com/u/208957?v=4)](https://github.com/umpirsky "umpirsky (11 commits)")[![AdamKasp](https://avatars.githubusercontent.com/u/29897151?v=4)](https://github.com/AdamKasp "AdamKasp (10 commits)")[![Arminek](https://avatars.githubusercontent.com/u/6368946?v=4)](https://github.com/Arminek "Arminek (8 commits)")[![NoResponseMate](https://avatars.githubusercontent.com/u/9448101?v=4)](https://github.com/NoResponseMate "NoResponseMate (5 commits)")[![Tomanhez](https://avatars.githubusercontent.com/u/39232096?v=4)](https://github.com/Tomanhez "Tomanhez (5 commits)")[![michalmarcinkowski](https://avatars.githubusercontent.com/u/7572437?v=4)](https://github.com/michalmarcinkowski "michalmarcinkowski (5 commits)")[![bendavies](https://avatars.githubusercontent.com/u/625392?v=4)](https://github.com/bendavies "bendavies (4 commits)")[![SirDomin](https://avatars.githubusercontent.com/u/22825722?v=4)](https://github.com/SirDomin "SirDomin (4 commits)")[![gorkalaucirica](https://avatars.githubusercontent.com/u/1749891?v=4)](https://github.com/gorkalaucirica "gorkalaucirica (3 commits)")[![kayue](https://avatars.githubusercontent.com/u/193112?v=4)](https://github.com/kayue "kayue (3 commits)")[![arti0090](https://avatars.githubusercontent.com/u/35863747?v=4)](https://github.com/arti0090 "arti0090 (3 commits)")[![damonsson](https://avatars.githubusercontent.com/u/3453169?v=4)](https://github.com/damonsson "damonsson (2 commits)")[![kalessil](https://avatars.githubusercontent.com/u/1577185?v=4)](https://github.com/kalessil "kalessil (2 commits)")[![arnolanglade](https://avatars.githubusercontent.com/u/3585922?v=4)](https://github.com/arnolanglade "arnolanglade (2 commits)")

---

Tags

syliusshopecommercepromotion

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/sylius-promotion/health.svg)

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

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[sylius/shipping

Flexible shipping component for PHP e-commerce projects.

13209.1k8](/packages/sylius-shipping)[sylius/core

Sylius e-commerce core. It integrates all components.

10143.1k31](/packages/sylius-core)[sylius/payment

Flexible payments system for PHP e-commerce applications.

17324.0k7](/packages/sylius-payment)[sylius/taxation

Flexible taxation system for PHP ecommerce applications.

11385.3k7](/packages/sylius-taxation)[sylius/taxonomy-bundle

Flexible categorization system for Symfony.

26388.2k7](/packages/sylius-taxonomy-bundle)

PHPackages © 2026

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