articles

The global articles object looks up a published article with a blog-handle/article-handle key. It is available in every storefront template.

Example

{% assign post = articles['journal/summer-care'] %}
{% if post %}
  <a href="{{ post.url }}">{{ post.title }}</a>
{% endif %}

Lookup behavior

• Both handles are normalized to lowercase, then must contain only letters, numbers, and hyphens, with no leading or trailing hyphen.
• One render can resolve at most 20 unique article keys. Repeated access to the same key reuses the request-scoped result.
• Missing, unpublished, malformed, and over-limit lookups return nil.
• Returned article URLs retain the active published locale prefix.

Use blogs when you need the blog first, or article for the returned object’s properties.

Properties

Property	Description

This object has no static properties; its validated lookup keys are dynamic.

Property list is generated from the storefront engine (ArticlesDrop), so it always matches what your theme can use. Use {{ articles | json }} only as a curated debug snapshot; it can omit lazy or otherwise public properties.