We use cookies to help our site work and to understand how it is used. By continuing to browse the site you're agreeing to our use of cookies.

Modular content fields

Note This guide assumes you have a basic knowledge of how Modular content fields work in DatoCMS. If this is not the case, please read this introduction first.

Suppose a blog_post model has a modular-content field called body, which in turn accepts the following models as building-blocks:

  • Model blog_post_text_block: made of a text field (multi-paragraph text);
  • Model blog_post_quote_block: made of a quote field (multi-paragraph text) and author field (single-line string);
  • Model blog_post_gallery_block: made of a gallery field (image gallery);

A modular-content field works much like a multiple links field, as it returns an array of the inner records. In your dato.config.rb file you can dump a modular-content field inside the frontmatter of a post like this:

# inside a "_posts" directory...
directory "_posts" do

  # ...iterate over the "Blog post" records...
  dato.blog_posts.each do |article|

    # ...and create a markdown file for each article!
    create_post "#{article.slug}.md" do
        title: article.title,
        author: article.author.name,
        body: article.body.to_hash

{{ page.title }}

{{ page.author }}

{% for record in page.body %} {% if record.item_type == "blog_post_text_block" %}
{{ record.text }}
{% elsif record.item_type == "blog_post_quote_block" %}
{{ record.quote }}
{{ record.author }}
{% elsif record.item_type == "blog_post_gallery_block" %} {% endif %} {% endfor %}