PHPackages                             superbig/craft3-templateselect - 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. superbig/craft3-templateselect

ActiveCraft-plugin[Templating & Views](/categories/templating)

superbig/craft3-templateselect
==============================

A fieldtype that allows you to select a template from a dropdown.

5.0.1(3mo ago)1744.9k↑350%10[2 PRs](https://github.com/sjelfull/craft3-templateselect/pulls)MITPHPPHP ^8.2CI failing

Since Oct 30Pushed 3mo ago2 watchersCompare

[ Source](https://github.com/sjelfull/craft3-templateselect)[ Packagist](https://packagist.org/packages/superbig/craft3-templateselect)[ RSS](/packages/superbig-craft3-templateselect/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (6)Dependencies (4)Versions (14)Used By (0)

Template Select plugin for Craft CMS
====================================

[](#template-select-plugin-for-craft-cms)

A fieldtype that allows you to select a template from the site templates folder.

[![Screenshot](resources/img/field-with-friendly.png)](resources/img/field-with-friendly.png)

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

[](#requirements)

This plugin requires Craft CMS 4.0 or later.

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

[](#installation)

To install the plugin, follow these instructions.

1. Open your terminal and go to your Craft project:

    ```
     cd /path/to/project

    ```
2. Then tell Composer to load the plugin:

    ```
     composer require superbig/craft3-templateselect

    ```
3. In the Control Panel, go to Settings → Plugins and click the “Install” button for Template Select.

Configuring template select
---------------------------

[](#configuring-template-select)

Create a new field and choose field type Template Select.

In the field settings, you can limit the list of available templates to a subfolder of the Craft templates folder. The path is relative, i.e. *subfolder/anotherfolder*. This may also be set to an ENV variable.

[![Screenshot](resources/img/field-settings.png)](resources/img/field-settings.png)

[![Screenshot](resources/img/field-without-friendly.png)](resources/img/field-without-friendly.png)

In the field settings, you can choose to make the template names more user friendly. In the field, the list will be improved by changing the following:

- file extensions will be removed
- the file names will be capitalized and spaced for readability
- folders will be separated by ›

[![Screenshot](resources/img/field-with-friendly.png)](resources/img/field-with-friendly.png)

Adding descriptions to templates
--------------------------------

[](#adding-descriptions-to-templates)

You can add descriptions to your templates to help users understand what each template does. This is especially useful when you have many templates to choose from.

To add a description to a template, add a special comment at the beginning of your template file:

```
{# @description: Displays a paginated list of blog posts with thumbnails and excerpts #}
```

The description will appear in the dropdown next to the template name, making it easier for content editors to select the right template.

**Examples:**

```
{# @description: Contact form with validation and CAPTCHA support #}

    ...

```

```
{# @description: Hero section with background image and call-to-action button #}

    ...

```

Descriptions can also span multiple lines:

```
{# @description: Complex product grid layout
   Includes filters, sorting, and pagination
   Supports up to 4 columns #}
```

**Note:** Templates without descriptions will still work normally and appear in the dropdown without any description text.

Using template select
---------------------

[](#using-template-select)

### Output the chosen template name:

[](#output-the-chosen-template-name)

```
{{ entry.fieldHandle }}
```

### Include/Embed the chosen template:

[](#includeembed-the-chosen-template)

```
{% include entry.fieldHandle %}
```

### Include the template including subfolder if set:

[](#include-the-template-including-subfolder-if-set)

```
{% include entry.fieldHandle.withSubfolder() %}
```

This is a alias for the following:

```
{{ entry.templateWithSubfolder.template(true) }}
```

### Output the subfolder name:

[](#output-the-subfolder-name)

```
{{ entry.fieldHandle.subfolder() }}
```

### Output the filename without path:

[](#output-the-filename-without-path)

```
{{ entry.fieldHandle.filename() }}
```

Brought to you by [Superbig](https://superbig.co)

###  Health Score

59

—

FairBetter than 99% of packages

Maintenance82

Actively maintained with recent releases

Popularity38

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity83

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 81.5% 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 ~606 days

Recently: every ~646 days

Total

6

Last Release

91d ago

Major Versions

2.0.2 → 3.0.02022-10-03

3.0.0 → 5.0.02024-05-12

### Community

Maintainers

![](https://www.gravatar.com/avatar/800b029eac606eb58930bcdf0d887e14aa63c31a203744c30befca8a58aa79b4?d=identicon)[superbig](/maintainers/superbig)

---

Top Contributors

[![sjelfull](https://avatars.githubusercontent.com/u/10508?v=4)](https://github.com/sjelfull "sjelfull (22 commits)")[![brandonkelly](https://avatars.githubusercontent.com/u/47792?v=4)](https://github.com/brandonkelly "brandonkelly (1 commits)")[![Copilot](https://avatars.githubusercontent.com/in/1143301?v=4)](https://github.com/Copilot "Copilot (1 commits)")[![john-henry](https://avatars.githubusercontent.com/u/44709?v=4)](https://github.com/john-henry "john-henry (1 commits)")[![Karl456](https://avatars.githubusercontent.com/u/1711413?v=4)](https://github.com/Karl456 "Karl456 (1 commits)")[![okolvik-avento](https://avatars.githubusercontent.com/u/47562698?v=4)](https://github.com/okolvik-avento "okolvik-avento (1 commits)")

---

Tags

craft-plugincraft3craftcmscraftcms-pluginfieldtypecmsCraftcraftcmscraft-plugintemplate select

### Embed Badge

![Health badge](/badges/superbig-craft3-templateselect/health.svg)

```
[![Health](https://phpackages.com/badges/superbig-craft3-templateselect/health.svg)](https://phpackages.com/packages/superbig-craft3-templateselect)
```

###  Alternatives

[lewisjenkins/craft-dynamic-fields

Populate Craft fields with dynamic data using the power of Twig.

14667.0k](/packages/lewisjenkins-craft-dynamic-fields)[nystudio107/craft-minify

A simple plugin that allows you to minify blocks of HTML, CSS, and JS inline in Craft CMS templates.

37461.2k29](/packages/nystudio107-craft-minify)[jalendport/craft-preparse

A fieldtype that parses Twig when an element is saved and saves the result as plain text.

1086.4k](/packages/jalendport-craft-preparse)[craftpulse/craft-colour-swatches

Let clients choose from a predefined set of colours and utilise associated colour codes and class names in your templates.

3530.8k2](/packages/craftpulse-craft-colour-swatches)[verbb/footnotes

Adds a footnotes feature to CKEditor fields and Twig templates.

213.3k](/packages/verbb-footnotes)

PHPackages © 2026

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