PHPackages                             dynamic/silverstripe-elemental-promos - 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. [Templating & Views](/categories/templating)
4. /
5. dynamic/silverstripe-elemental-promos

ActiveSilverstripe-vendormodule[Templating & Views](/categories/templating)

dynamic/silverstripe-elemental-promos
=====================================

A block to display a group of promo objects - a small card with an image, headline, short description, and link.

6.0.0(3mo ago)034.6k↓35.2%8[2 issues](https://github.com/dynamic/silverstripe-elemental-promos/issues)2BSD-3-ClausePHPCI passing

Since May 8Pushed 3mo ago6 watchersCompare

[ Source](https://github.com/dynamic/silverstripe-elemental-promos)[ Packagist](https://packagist.org/packages/dynamic/silverstripe-elemental-promos)[ GitHub Sponsors](https://github.com/sponsors/dynamic)[ RSS](/packages/dynamic-silverstripe-elemental-promos/feed)WikiDiscussions 6 Synced 1mo ago

READMEChangelog (10)Dependencies (4)Versions (30)Used By (2)

Silverstripe Elemental Promos
=============================

[](#silverstripe-elemental-promos)

A block to display a group of promos - a small card with an image, headline, short description, and link.

[![CI](https://github.com/dynamic/silverstripe-elemental-promos/actions/workflows/ci.yml/badge.svg)](https://github.com/dynamic/silverstripe-elemental-promos/actions/workflows/ci.yml) [![Sponsors](https://camo.githubusercontent.com/475eb602a82fd79c0c52637caf359d39fd4a787ed0028b31af22a60fbe6dccb5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4769744875622d53706f6e736f72732d6666363962343f6c6f676f3d676974687562)](https://github.com/sponsors/dynamic)

[![Latest Stable Version](https://camo.githubusercontent.com/8fe44c46686eb91bec8116feaee12aaa75aab60a49faf948238867e8bf2ea2a2/68747470733a2f2f706f7365722e707567782e6f72672f64796e616d69632f73696c7665727374726970652d656c656d656e74616c2d70726f6d6f732f762f737461626c65)](https://packagist.org/packages/dynamic/silverstripe-elemental-promos)[![Total Downloads](https://camo.githubusercontent.com/a8313643a66f2bc416306c525a8f1c7d3506adbca02521bd55331c905be37e93/68747470733a2f2f706f7365722e707567782e6f72672f64796e616d69632f73696c7665727374726970652d656c656d656e74616c2d70726f6d6f732f646f776e6c6f616473)](https://packagist.org/packages/dynamic/silverstripe-elemental-promos)[![Latest Unstable Version](https://camo.githubusercontent.com/9cabaa9b0c99fd260428d914c4d2234be3093fd3439305e15f8bc16bf878e3fa/68747470733a2f2f706f7365722e707567782e6f72672f64796e616d69632f73696c7665727374726970652d656c656d656e74616c2d70726f6d6f732f762f756e737461626c65)](https://packagist.org/packages/dynamic/silverstripe-elemental-promos)[![License](https://camo.githubusercontent.com/17ebb73896c9e5b3fb35dd51c0daf0ee962a62aec5b32c10db2c0afb5317557a/68747470733a2f2f706f7365722e707567782e6f72672f64796e616d69632f73696c7665727374726970652d656c656d656e74616c2d70726f6d6f732f6c6963656e7365)](https://packagist.org/packages/dynamic/silverstripe-elemental-promos)

Requirements
------------

[](#requirements)

- dnadesign/silverstripe-elemental: ^5
- dynamic/silverstripe-elemental-baseobject: ^5
- jonom/focuspoint: ^5

Installation
------------

[](#installation)

`composer require dynamic/silverstripe-elemental-promos`

License
-------

[](#license)

See [License](LICENSE.md)

Usage
-----

[](#usage)

A content block to display a group of promos - a small card with an image, headline, short description, and link. Typically this will display 3 to 4 promos per row depending on layout restrictions.

### Template Notes

[](#template-notes)

The default templates are based off [Bootstrap 5](https://getbootstrap.com/) classes/styling

Screen Shots
------------

[](#screen-shots)

#### Default Template of a Promos Element

[](#default-template-of-a-promos-element)

[![Default Template of a Promos Element](./docs/en/_images/promos-block-sample.png)](./docs/en/_images/promos-block-sample.png)

#### CMS - Promos Main Tab

[](#cms---promos-main-tab)

[![CMS - Promos Block Main Tab](./docs/en/_images/promos-block-cms.png)](./docs/en/_images/promos-block-cms.png)

#### CMS - Promos Block - Promo Edit

[](#cms---promos-block---promo-edit)

[![CMS - Promos Block - Promos Edit](./docs/en/_images/promos-block-cms-promo-edit.png)](./docs/en/_images/promos-block-cms-promo-edit.png)

Upgrading from version 4
------------------------

[](#upgrading-from-version-4)

This module drops `gorriecoe/silverstripe-linkfield` usage in favor of `silverstripe/linkfield`.

Getting more elements
---------------------

[](#getting-more-elements)

See [Elemental modules by Dynamic](https://github.com/orgs/dynamic/repositories?q=elemental&type=all&language=&sort=)

Configuration
-------------

[](#configuration)

See [SilverStripe Elemental Configuration](https://github.com/silverstripe/silverstripe-elemental#configuration)

Translations
------------

[](#translations)

The translations for this project are managed via [Transifex](https://www.transifex.com/dynamicagency/silverstripe-elemental-promos/)and are updated automatically during the release process. To contribute, please head to the link above and get translating!

Maintainers
-----------

[](#maintainers)

- [Dynamic](https://www.dynamicagency.com) ()

Bugtracker
----------

[](#bugtracker)

Bugs are tracked in the issues section of this repository. Before submitting an issue please read over existing issues to ensure yours is unique.

If the issue does look like a new bug:

- Create a new issue
- Describe the steps required to reproduce your issue, and the expected outcome. Unit tests, screenshots and screencasts can help here.
- Describe your environment as detailed as possible: SilverStripe version, Browser, PHP version, Operating System, any installed SilverStripe modules.

Please report security issues to the module maintainers directly. Please don't file security issues in the bugtracker.

Development and contribution
----------------------------

[](#development-and-contribution)

If you would like to make contributions to the module please ensure you raise a pull request and discuss with the module maintainers.

###  Health Score

54

—

FairBetter than 97% of packages

Maintenance79

Regular maintenance activity

Popularity30

Limited adoption so far

Community23

Small or concentrated contributor base

Maturity74

Established project with proven stability

 Bus Factor1

Top contributor holds 70% 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 ~100 days

Recently: every ~133 days

Total

29

Last Release

110d ago

Major Versions

2.1.x-dev → 3.0.0-alpha12022-11-23

3.0.0 → 4.0.0-alpha12023-06-13

3.x-dev → 4.0.12023-10-18

4.x-dev → 5.0.02025-01-24

5.x-dev → 6.0.02026-01-28

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/867942?v=4)[Dynamic](/maintainers/dynamic)[@dynamic](https://github.com/dynamic)

---

Top Contributors

[![jsirish](https://avatars.githubusercontent.com/u/1163643?v=4)](https://github.com/jsirish "jsirish (49 commits)")[![muskie9](https://avatars.githubusercontent.com/u/870751?v=4)](https://github.com/muskie9 "muskie9 (13 commits)")[![mak001](https://avatars.githubusercontent.com/u/1750550?v=4)](https://github.com/mak001 "mak001 (3 commits)")[![AntonyThorpe](https://avatars.githubusercontent.com/u/1023740?v=4)](https://github.com/AntonyThorpe "AntonyThorpe (2 commits)")[![korthjp17](https://avatars.githubusercontent.com/u/3858661?v=4)](https://github.com/korthjp17 "korthjp17 (1 commits)")[![Copilot](https://avatars.githubusercontent.com/in/1143301?v=4)](https://github.com/Copilot "Copilot (1 commits)")[![wernerkrauss](https://avatars.githubusercontent.com/u/1043925?v=4)](https://github.com/wernerkrauss "wernerkrauss (1 commits)")

---

Tags

hacktoberfestsilverstripesilverstripe-elementalsilverstripecontentcardblockselementalpromospiff

### Embed Badge

![Health badge](/badges/dynamic-silverstripe-elemental-promos/health.svg)

```
[![Health](https://phpackages.com/badges/dynamic-silverstripe-elemental-promos/health.svg)](https://phpackages.com/packages/dynamic-silverstripe-elemental-promos)
```

###  Alternatives

[nobrainerweb/silverstripe-content-blocks

Split your page content into manageable blocks/sections of content, each with their own template

301.5k](/packages/nobrainerweb-silverstripe-content-blocks)

PHPackages © 2026

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