---
title: "article"

doc_type: static
doc_category: static
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/docs/sline/object/article'
  md: 'https://developer.shopline.com/docs/sline/object/article.md'
---

# article


    An article, or blog post, in a blog.

    



## Properties

    <div>
    

        
<ObjectProperty 
    name="author"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
The full name of the author of the article.


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty 
    name="comments"
    types={[<Mdx>array of [comment](https://developer.shopline.com/docs/sline/object/comment.md)</Mdx>]}
>
<ObjectSummary>
The published comments for the article.


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty 
    name="comments_count"
    types={[<Mdx>integer</Mdx>]}
>
<ObjectSummary>
The number of published comments for the article.


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty 
    name="comments_enabled"
    types={[<Mdx>boolean</Mdx>]}
>
<ObjectSummary>
Whether comments are enabled.
- `true`: Enabled
- `false`: Disabled


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty 
    name="content"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
The content of the article.


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty 
    name="created_at"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
A timestamp for when the article was created. Format: [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html).

> **Tip**
>
> Use the [date](https://developer.shopline.com/docs/sline/filter/date.md) filter to format the timestamp.
</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty 
    name="excerpt"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
The excerpt of the article.


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty 
    name="excerpt_or_content"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
Returns the article excerpt if it exists. Returns the article content if no excerpt exists.


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty 
    name="handle"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
The [handle](https://developer.shopline.com/docs/sline/basics.md#kRuFt) of the article.


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty 
    name="id"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
The ID of the article.


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty 
    name="image"
    types={[<Mdx>[image](https://developer.shopline.com/docs/sline/object/image.md)</Mdx>]}
>
<ObjectSummary>
The featured image for the article.


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty 
    name="published_at"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
A timestamp for when the article was published. Format: [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html).

> **Tip**
>
> Use the [date](https://developer.shopline.com/docs/sline/filter/date.md) filter to format the timestamp.
</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty 
    name="title"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
The title of the article.


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty 
    name="updated_at"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
A timestamp for when the article was updated. Format: [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html).

> **Tip**
>
> Use the [date](https://developer.shopline.com/docs/sline/filter/date.md) filter to format the timestamp.
</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty 
    name="url"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
The relative URL of the article.


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty 
    name="moderated"
    types={[<Mdx>boolean</Mdx>]}
>
<ObjectSummary>
Whether moderation is required for the comments.
- `true`: Required
- `false`: Not required


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty 
    name="tags"
    types={[<Mdx>array of string</Mdx>]}
>
<ObjectSummary>
A list of tags applied to the article.


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty 
    name="template_suffix"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
The name of the custom template for the article.

The name does not include the prefix or the file extension. For example, if the template is `article.xxx.json`, `xxx` is returned.

If the article uses the default template, `nil` is returned.


</ObjectSummary>
</ObjectProperty>
        
    
    </div>