Advanced

Custom modules & Ingredients

Alchemy can be extended with your own admin modules and Ingredient types. This page manages a custom Event model in the admin and surfaces it two ways below.

config/alchemy/elements.yml

- name: concept_intro
  hint: true
  ingredients:
    - role: eyebrow
      type: Text
      hint: true
      default: :concept_intro_eyebrow
    - role: headline
      type: Headline
      as_element_title: true
      hint: true
      default: :concept_intro_headline
      settings:
        levels: [1, 2]
        sizes: [1, 2]
        anchor: from_value
    - role: lead
      type: Richtext
      hint: true
      default: :concept_intro_lead
      settings:
        tinymce:
          toolbar: "bold italic | alchemy_link unlink"
        sanitizer:
          tags: [p, br, strong, em, a]
          attributes: [href, target, rel, title]

Edit this element in the admin →

Upcoming events

December 10, 2026

Year-end Community Call

📍 Online

Roadmap, thanks and open Q&A to close out the year.

config/alchemy/elements.yml

- name: events_overview
  hint: true
  ingredients:
    - role: headline
      type: Headline
      hint: true
      default: :events_overview_headline
      settings:
        levels: [2, 3]
        sizes: [2, 3]
    - role: timeframe
      type: Select
      hint: true
      default: upcoming
      settings:
        select_values:
          - ["Upcoming", "upcoming"]
          - ["Past", "past"]
          - ["All", "all"]
    - role: display
      type: Select
      group: styling
      hint: true
      default: timeline
      settings:
        select_values:
          - ["Timeline", "timeline"]
          - ["Calendar", "calendar"]

Edit this element in the admin →

Full calendar

March 2026

Mar 14

Alchemy Contributor Summit

📍 Berlin, Germany

Two days of talks and hacking with the Alchemy core team and contributors.

May 2026

May 6

Ruby on Rails Meetup

📍 Cologne, Germany

A casual evening of lightning talks about Rails and CMS development.

June 2026

Jun 20

CMS Field Day

📍 Amsterdam, Netherlands

Hands-on workshops on structuring content with Elements and Ingredients.

September 2026

Sep 30

Alchemy 8 Release Party

📍 Online

Celebrating the Alchemy 8 release with a live walkthrough of what's new.

October 2026

Oct 22

Content Modeling Workshop

📍 Hamburg, Germany

Design custom modules and ingredients for real editorial workflows.

December 2026

Dec 10

Year-end Community Call

📍 Online

Roadmap, thanks and open Q&A to close out the year.

config/alchemy/elements.yml

- name: events_overview
  hint: true
  ingredients:
    - role: headline
      type: Headline
      hint: true
      default: :events_overview_headline
      settings:
        levels: [2, 3]
        sizes: [2, 3]
    - role: timeframe
      type: Select
      hint: true
      default: upcoming
      settings:
        select_values:
          - ["Upcoming", "upcoming"]
          - ["Past", "past"]
          - ["All", "all"]
    - role: display
      type: Select
      group: styling
      hint: true
      default: timeline
      settings:
        select_values:
          - ["Timeline", "timeline"]
          - ["Calendar", "calendar"]

Edit this element in the admin →

December 10, 2026

Year-end Community Call

📍 Online

Roadmap, thanks and open Q&A to close out the year.

config/alchemy/elements.yml

- name: event_teaser
  hint: true
  ingredients:
    - role: event
      type: Event
      hint: true

Edit this element in the admin →

December 10, 2026

Year-end Community Call

📍 Online

Roadmap, thanks and open Q&A to close out the year.

config/alchemy/elements.yml

- name: event_teaser
  hint: true
  ingredients:
    - role: event
      type: Event
      hint: true

Edit this element in the admin →

December 10, 2026

Year-end Community Call

📍 Online

Roadmap, thanks and open Q&A to close out the year.

config/alchemy/elements.yml

- name: event_teaser
  hint: true
  ingredients:
    - role: event
      type: Event
      hint: true

Edit this element in the admin →