Skip to main content

Blog Post Fields

Blog posts, or articles, are individual posts in a blog

Updated this week

Sample File

This sample file shows the basics columns that you need to set in order to import blog posts to Shopify.

Download sample Blog Posts Import File.

General

ID

Description

Example Value

Shopify's unique article identifier

12345678

If present, the ID will be used to group multiple rows together into a single article. When importing, the ID will be used to see if the article already exists on the store. If there's no ID match the app will attempt to find an existing article using the Handle.

Handle

Description

Example Value

URL-friendly article identifier

summer-fashion-trends-2023

The handle is the URL-friendly version of the article title used in the article's URL. The handle is used for grouping multiple rows together into a single article and finding an existing article on the store if the ID is not present.

Command

Description

Example Value

Action to perform: MERGE, DELETE, NEW

MERGE

  • MERGE: Update existing article or create if not found

  • DELETE: Remove the article from the store

  • NEW: Create a new article (will fail if article already exists)

Title

Description

Example Value

Article title

Summer Fashion Trends 2023

The main title of the article that will be displayed to readers.

Author

Description

Example Value

Article author name

Jane Smith

The name of the person who wrote the article. This appears in the article's metadata.

Body HTML

Description

Example Value

Article content

<p>This summer's hottest trends...</p>

The main content of the article in HTML format.

Tags

Description

Example Value

Comma-separated article tags

fashion, summer, trends

Tags help categorize and organize articles, making them easier to find and filter.

Tags Command

Description

Example Value

Tag action: ADD, REPLACE, REMOVE

ADD

  • ADD: Add the specified tags to existing tags

  • REPLACE: Replace all existing tags with specified tags

  • REMOVE: Remove the specified tags from the article

Created At

Description

Example Value

Article creation date/time

2023-05-15 14:30:00 -0400

The timestamp when the article was originally created in Shopify.

Updated At

Description

Example Value

Last modification date/time

2023-06-02 09:15:00 -0400

The timestamp when the article was last modified or updated.

Published

Description

Example Value

If the article is published to the blog

TRUE

  • TRUE: Article is published and visible to customers

  • FALSE: Article is unpublished and hidden from customers

Published At

Description

Example Value

Publication date/time

2023-06-01 10:00:00 -0400

If 'Published At' is in the future, the article will be scheduled for publication at that time.

ISO-formatted timestamps (eg, 2025-06-01T10:00:00Z) are also supported. If no timezone is specified, the store's timezone will be used.

Template Suffix

Description

Example Value

Template suffix for article

featured-post

Allows you to use a custom template for displaying this specific article.

Image Src

Description

Example Value

Article image URL

https://cdn.shopify.com/s/files/1/0001/article.jpg

The URL of the featured image that represents the article.

Image Width

Description

Example Value

Image width (pixels) - Export only

800

The width of the article's featured image in pixels. This field is export-only and cannot be imported.

Image Height

Description

Example Value

Image height (pixels) - Export only

600

The height of the article's featured image in pixels. This field is export-only and cannot be imported.

Image Alt Text

Description

Example Value

Image alternative text

Summer fashion trends for 2023

Alternative text for accessibility and SEO.

Blogs

Blog: ID

Description

Example Value

Parent blog identifier

987654

The unique identifier of the blog that contains this article.

Blog: Handle

Description

Example Value

Parent blog handle

fashion-blog

The URL handle of the blog where this article belongs.

Blog: Title

Description

Example Value

Parent blog title

Fashion & Style

The title of the blog that contains this article.

Blog: Commentable

Description

Example Value

Comment policy: TRUE, FALSE, moderated

moderated

  • TRUE: Comments are enabled and published immediately

  • FALSE: Comments are disabled

  • moderated: Comments require approval before publishing

Blog: Template Suffix

Description

Example Value

Blog template suffix

fashion-template

Alternative template suffix used for the parent blog.

Comments

Row

Description

Example Value

Row number for multi-row data

2

Used when an article spans multiple rows (e.g., when including comments).

Top Row

Description

Example Value

Main article row: TRUE, FALSE

TRUE

  • TRUE: This is the primary row for the article

  • FALSE: This is a secondary row (e.g., for comments or additional data)

Comment: ID

Description

Example Value

Comment identifier

456789

The unique identifier for a specific comment on the article.

Comment: Author

Description

Example Value

Comment author

John Doe

The name of the person who posted the comment.

Comment: Body HTML

Description

Example Value

Comment content

<p>Great article!</p>

The content of the comment in HTML format.

Metafields and SEO

Metafields can be imported and exported with articles to store custom metadata, SEO information, and additional attributes.

For detailed information about working with metafields, see our Metafields guide.

Export Filters

You can use these filters to limit which articles are exported:

  • author: Filter by article author

  • blog_title: Filter by blog title

  • created_at: Filter by creation date

  • updated_at: Filter by last updated date

  • tag: Filter by article tags

Did this answer your question?