---
title: "Liquid objects: article"
description: An article, or [blog post](https://help.shopify.com/manual/online-store/blogs/writing-blogs), in a blog.
api_name: liquid
source_url:
html: https://shopify.dev/docs/api/liquid/objects/article
md: https://shopify.dev/docs/api/liquid/objects/article.md
---
# article
An article, or [blog post](https://help.shopify.com/manual/online-store/blogs/writing-blogs), in a blog.
## Properties
* * author
[string](https://shopify.dev/docs/api/liquid/basics#string)
* The full name of the author of the article.
* comment\_post\_url
[string](https://shopify.dev/docs/api/liquid/basics#string)
* The relative URL where POST requests are sent when creating new comments.
* comments
array of [comment](https://shopify.dev/docs/api/liquid/objects/comment)
* The published comments for the article.
Returns an empty array if comments are disabled.
Tip
Use the [paginate](https://shopify.dev/docs/api/liquid/tags/paginate) tag to choose how many comments to show at once, up to a limit of 50.
* comments\_count
[number](https://shopify.dev/docs/api/liquid/basics#number)
* The number of published comments for the article.
* comments\_enabled?
[boolean](https://shopify.dev/docs/api/liquid/basics#boolean)
* Returns `true` if comments are enabled. Returns `false` if not.
* content
[string](https://shopify.dev/docs/api/liquid/basics#string)
* The content of the article.
* created\_at
[string](https://shopify.dev/docs/api/liquid/basics#string)
* A timestamp for when the article was created.
Tip
Use the [`date` filter](https://shopify.dev/docs/api/liquid/filters/date) to format the timestamp.
* excerpt
[string](https://shopify.dev/docs/api/liquid/basics#string)
* The excerpt of the article.
* excerpt\_or\_content
[string](https://shopify.dev/docs/api/liquid/basics#string)
* Returns the article [excerpt](https://shopify.dev/docs/api/liquid/objects/article#article-excerpt) if it exists. Returns the article [content](https://shopify.dev/docs/api/liquid/objects/article#article-content) if no excerpt exists.
* handle
[string](https://shopify.dev/docs/api/liquid/basics#string)
* The [handle](https://shopify.dev/docs/api/liquid/basics#handles) of the article.
* id
[string](https://shopify.dev/docs/api/liquid/basics#string)
* The ID of the article.
* image
[image](https://shopify.dev/docs/api/liquid/objects/image)
* The featured image for the article.
* metafields
* The [metafields](https://shopify.dev/docs/api/liquid/objects/metafield) applied to the article.
Tip
To learn about how to create metafields, refer to [Create and manage metafields](https://shopify.dev/apps/metafields/manage) or visit the [Shopify Help Center](https://help.shopify.com/manual/metafields).
* moderated?
[boolean](https://shopify.dev/docs/api/liquid/basics#boolean)
* Returns `true` if the blog that the article belongs to is set to [moderate comments](https://help.shopify.com/manual/online-store/blogs/managing-comments). Returns `false` if not.
* published\_at
[string](https://shopify.dev/docs/api/liquid/basics#string)
* A timestamp for when the article was published.
Tip
Use the [`date` filter](https://shopify.dev/docs/api/liquid/filters/date) to format the timestamp.
* tags
array of [string](https://shopify.dev/docs/api/liquid/basics#string)
* The tags applied to the article.
ExampleShow the total tag count
When looping through `article.tags`, you can print how many times a tag is used with `tag.total_count`. This number shows visitors how many blog posts have been tagged with a particular tag.
```liquid
{% for tag in article.tags -%}
{{ tag }} ({{ tag.total_count }})
{%- endfor %}
```
##### Code
```
{% for tag in article.tags -%}
{{ tag }} ({{ tag.total_count }})
{%- endfor %}
```
##### Data
```
{
"article": {
"tags": [
"clear potions",
"potion troubleshooting",
"tips"
]
}
}
```
## Output
```html
clear potions (1)potion troubleshooting (2)tips (2)
```
* template\_suffix
[string](https://shopify.dev/docs/api/liquid/basics#string)
* The name of the [custom template](https://shopify.dev/themes/architecture/templates#alternate-templates) assigned to the article.
The name doesn't include the `article.` prefix, or the file extension (`.json` or `.liquid`).
If a custom template isn't assigned to the article, then `nil` is returned.
* title
[string](https://shopify.dev/docs/api/liquid/basics#string)
* The title of the article.
* updated\_at
[string](https://shopify.dev/docs/api/liquid/basics#string)
* A timestamp for when the article was updated.
Tip
Use the [`date` filter](https://shopify.dev/docs/api/liquid/filters/date) to format the timestamp.
* url
[string](https://shopify.dev/docs/api/liquid/basics#string)
* The relative URL of the article.
* user
[user](https://shopify.dev/docs/api/liquid/objects/user)
* The user associated with the author of the article.
```json
{
"author": "Polina Waters",
"comment_post_url": "/blogs/potion-notions/how-to-tell-if-you-have-run-out-of-invisibility-potion/comments",
"comments": [],
"comments_count": 1,
"comments_enabled?": true,
"content": "We've all had this problem before: we peek into the potions vault to determine which potions we are running low on, and the invisibility potion bottle looks completely empty.
\n...
\n
",
"created_at": "2022-04-14 16:56:02 -0400",
"excerpt": "And where to buy more!",
"excerpt_or_content": "And where to buy more!",
"handle": "potion-notions/how-to-tell-if-you-have-run-out-of-invisibility-potion",
"id": 556510085185,
"image": {},
"metafields": {},
"moderated?": true,
"published_at": "2022-04-14 16:56:02 -0400",
"tags": [],
"template_suffix": "",
"title": "How to tell if you're out of invisibility potion",
"updated_at": "2022-06-04 19:27:33 -0400",
"url": {},
"user": {}
}
```
##### Example
```
{
"author": "Polina Waters",
"comment_post_url": "/blogs/potion-notions/how-to-tell-if-you-have-run-out-of-invisibility-potion/comments",
"comments": [],
"comments_count": 1,
"comments_enabled?": true,
"content": "We've all had this problem before: we peek into the potions vault to determine which potions we are running low on, and the invisibility potion bottle looks completely empty.
\n...
\n
",
"created_at": "2022-04-14 16:56:02 -0400",
"excerpt": "And where to buy more!",
"excerpt_or_content": "And where to buy more!",
"handle": "potion-notions/how-to-tell-if-you-have-run-out-of-invisibility-potion",
"id": 556510085185,
"image": {},
"metafields": {},
"moderated?": true,
"published_at": "2022-04-14 16:56:02 -0400",
"tags": [],
"template_suffix": "",
"title": "How to tell if you're out of invisibility potion",
"updated_at": "2022-06-04 19:27:33 -0400",
"url": {},
"user": {}
}
```
## Templates using article
[](https://shopify.dev/themes/architecture/templates/article)
[Theme architecturearticle template](https://shopify.dev/themes/architecture/templates/article)