Skip to content

Document multiple selection option for Select ingredient#276

Open
antwertinger wants to merge 2 commits intoAlchemyCMS:mainfrom
foureb:main
Open

Document multiple selection option for Select ingredient#276
antwertinger wants to merge 2 commits intoAlchemyCMS:mainfrom
foureb:main

Conversation

@antwertinger
Copy link
Copy Markdown

Summary

Adds documentation for the new multiple setting on the Select ingredient that enables multiple value selection.

Changes

  • Updated Select ingredient description to explain Array storage for multiple selections
  • Added multiple: true setting documentation with default value
  • Added two examples: single selection (default) and multiple selection
  • Clarified that values are stored as String by default and as Array when multiple is enabled

Example Usage

- name: categories
  type: Select
  settings:
    select_values: ['Technology', 'Design', 'Marketing', 'Sales']
    multiple: true

Marc Antwertinger added 2 commits November 6, 2025 11:49
Add documentation for the new multiple: true setting that allows users to select multiple values from a Select ingredient.
Comment thread guides/ingredients.md

* **default** `String` (optional)

A default value to prefill newly created elements. The value must be one of the values from `select_values`.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The value must be one of the values from select_values.

No, the value must not be one of the select_values. It can be any value.

Comment thread guides/ingredients.md

A list of values your users can select from. Use [a two dimensional array](https://guides.rubyonrails.org/form_helpers.html#the-select-and-option-tags) for having value and text pairs.

* **multiple** `Boolean` (default: false)
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We need a note about the minor version this was introduced. 8.1 in this case

@tvdeyen
Copy link
Copy Markdown
Member

tvdeyen commented Mar 9, 2026

@antwertinger also integrated in 8a59d18 now. Adjust if necessary

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants