PHPackages                             shel/neos-previewselectbox - 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 & Helpers](/categories/utility)
4. /
5. shel/neos-previewselectbox

Abandoned → [neos/neos-ui](/?search=neos%2Fneos-ui)Neos-plugin[Utility & Helpers](/categories/utility)

shel/neos-previewselectbox
==========================

Adds a new selectboxeditor supporting previews for items

1.1.0(2y ago)414.2k↑250%2GPL-3.0+JavaScript

Since May 26Pushed 2y ago1 watchersCompare

[ Source](https://github.com/Sebobo/Shel.Neos.PreviewSelectBox)[ Packagist](https://packagist.org/packages/shel/neos-previewselectbox)[ RSS](/packages/shel-neos-previewselectbox/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (1)Versions (3)Used By (0)

Neos CMS selectbox editor with preview
======================================

[](#neos-cms-selectbox-editor-with-preview)

This plugin adds a new variant of the Neos selectbox editor that supports `preview` properties on options and shows those when selecting an items in the selectbox.

In Neos CMS only the `AssetEditor` and `NodeEditor` have this feature and it's not possible yet to use this for other data types.

⚠️ This feature is integrated into Neos CMS (7.3+) and this plugin allows to use it for older Neos versions 4.3+. Check the [pull request](https://github.com/neos/neos-ui/pull/2930) and related issue for details. No new features will be added to this package and it will be archived, when Neos 7.3 is EOL!

[![Example](example.jpg)](example.jpg)

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

[](#installation)

Install the package `shel/neos-previewselectbox` via composer as dependency of your sitepackage.

How to use
----------

[](#how-to-use)

Instead of setting the `icon` property for each value, you set `preview` to an absolute uri.

⚠️ Relative uris might work, but are not officially supported, as they might not resolve in a reliable way depending on the hosting environment.

### With a datasource

[](#with-a-datasource)

Make sure the datasource returns a `preview` property with an absolute url for each item returned.

```
'My.Vendor:Content.Something':
  superTypes:
    Neos.Neos:Content: true
  ui:
    label: i18n
  properties:
    icon:
      type: string
      ui:
        label: 'Icon'
        reloadIfChanged: true
        inspector:
          group: icon
          editor: Shel.Neos/PreviewSelectBoxEditor
          editorOptions:
            placeholder: Select an icon
            allowEmpty: true
            dataSourceIdentifier: my-icon-datasource
```

### Without datasource

[](#without-datasource)

```
'My.Vendor:Content.Something':
  superTypes:
    Neos.Neos:Content: true
  ui:
    label: i18n
  properties:
    icon:
      type: string
      ui:
        label: 'Icon'
        reloadIfChanged: true
        inspector:
          group: icon
          editor: Shel.Neos/PreviewSelectBoxEditor
          editorOptions:
            placeholder: Select an icon
            allowEmpty: true
            values:
              'foo':
                label: Foo
                preview: https://some.url/my-foo-icon.svg
              'bar':
                label: Bar
                preview: https://some.url/my-bar-icon.svg
```

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity30

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 80% 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 ~861 days

Total

2

Last Release

957d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/5c9f106db319e8698dcb4aedfe8034f0442d379ebbd78fcd67b884999b2236f1?d=identicon)[Sebobo](/maintainers/Sebobo)

---

Top Contributors

[![Sebobo](https://avatars.githubusercontent.com/u/596967?v=4)](https://github.com/Sebobo "Sebobo (4 commits)")[![rolandschuetz](https://avatars.githubusercontent.com/u/735982?v=4)](https://github.com/rolandschuetz "rolandschuetz (1 commits)")

---

Tags

neos-cmsNeosneoscms

### Embed Badge

![Health badge](/badges/shel-neos-previewselectbox/health.svg)

```
[![Health](https://phpackages.com/badges/shel-neos-previewselectbox/health.svg)](https://phpackages.com/packages/shel-neos-previewselectbox)
```

###  Alternatives

[shel/neos-colorpicker

A plugin for Neos CMS which provides a colorpicker editor

1494.4k6](/packages/shel-neos-colorpicker)[shel/neos-hyphens

A plugin for Neos CMS which provides hyphens for the inline editor

20200.7k1](/packages/shel-neos-hyphens)[techdivision/ckstyles

Neos package which enables you adding your custom style classes for the CkEditor with a simple Yaml configuration

21166.3k](/packages/techdivision-ckstyles)[moc/notfound

Neos CMS package that loads a normal editable page for displaying a 404 error

18167.5k](/packages/moc-notfound)[carbon/includeassets

Include your assets (css, js) in an easy way into Neos

14228.6k10](/packages/carbon-includeassets)[shel/neos-commandbar

A commandbar (CMD+K) for Neos CMS

1614.6k1](/packages/shel-neos-commandbar)

PHPackages © 2026

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