blog_articles

Lets the merchant select a blog and returns it with its articles included. Perfect for "Latest Posts" or "Featured Blog" sections.

blog vs blog_articles

Unlike blog which returns only the blog info, blog_articles also fetches the articles inside the selected blog.

Properties

Property	Type	Required	Description
type	"blog_articles"	Yes	Field type identifier
label	string	Yes	Label shown in the builder
default	string	No	Default value (empty string if omitted)

Usage

schema.json

{
  "featuredBlog": {
    "type": "blog_articles",
    "label": "Featured Blog",
    "default": ""
  }
}

Template

{% if widget.settings.featuredBlog %}
  <h2>{{ widget.settings.featuredBlog.title }}</h2>

  <div class="articles-grid">
    {% for article in widget.settings.featuredBlog.articles %}
      <div class="article-card">
        {% if article.image %}
          <img src="{{ article.image.fileUrl }}" alt="{{ article.title }}">
        {% endif %}
        <h3>{{ article.title }}</h3>
        <p>{{ article.excerpt }}</p>
      </div>
    {% endfor %}
  </div>
{% endif %}

Output

{
  "featuredBlog": {
    "_id": "691f38a8a60232b8a1049823",
    "title": "Store News",
    "handle": "store-news",
    "articlesCount": 3,
    "articles": [
      {
        "_id": "69248443e2f94be6c3772ecc",
        "title": "New Collection Launch",
        "handle": "new-collection-launch",
        "excerpt": "Check out our latest collection...",
        "image": { "fileUrl": "https://cdn.qumra.cloud/media/..." },
        "publishedAt": "2025-01-15T10:00:00Z"
      },
      {
        "_id": "692483d8e2f94be6c3772dcc",
        "title": "Summer Sale Tips",
        "handle": "summer-sale-tips",
        "excerpt": "Get ready for the summer...",
        "image": { "fileUrl": "https://cdn.qumra.cloud/media/..." },
        "publishedAt": "2025-01-10T10:00:00Z"
      }
    ]
  }
}

Interactive Preview

Interactive Preview

Featured Blog

Store News

3 articles

New Collection Launch

Summer Sale Tips

Style Guide 2025

Live Output

{
  "featuredBlog": {
    "title": "Store News",
    "articlesCount": 3,
    "articles": [
      {
        "title": "New Collection Launch",
        "excerpt": "Check out our latest..."
      },
      {
        "title": "Summer Sale Tips",
        "excerpt": "Get ready for the summer..."
      },
      {
        "title": "Style Guide 2025",
        "excerpt": "This year's trends..."
      }
    ]
  }
}