# Blog posts

Bring customers to your articles, updates, and stories from any page. The **Blog posts** section shows the latest posts from one of your blogs in a grid of cards.
## Before you start
The section shows posts you've already published in Shopify. To add a post:
1. Go to **Content** > [**Blog posts**](https://admin.shopify.com/content/articles) in Shopify Admin.
2. Click **Add blog post**.
3. Enter a **Title** and your article content.
4. Select the **Blog** and **Author**.
5. Add a featured **Image**, an **Excerpt**, and **Tags** if you want them on the card.
6. Set **Visibility** to **Visible**.
7. Click **Save**.

See [Shopify's guide to blog posts](https://help.shopify.com/en/manual/online-store/blogs/writing-blogs/working-with-blog-posts).
## How to add Blog posts
1. Open the theme editor (**Edit theme**).
2. Click **Add section** under **Template** in the sidebar.
3. Select **Blog posts**.
4. Click **Select** next to **Blog** under **Content**.
5. Choose the blog to show.
6. Set **Posts to show**.
7. Click **Save**.
If **Blog posts** is already on the page, click it to edit it instead.
## Section settings
**Section header**, **General** (**Container type** and **Color scheme**), **Section Padding**, **Custom Attributes**, and **Animations** work the same as in every section. See [Common section settings](https://docs.foxecom.com/minimog-theme/theme-sections/common-section-settings).
### Content
Which blog the posts come from, and how many show in each row.
| Setting | Description | Options |
| ------------------------ | ---------------------------------------------- | ---------------------------------- |
| **Blog** | The blog whose posts show in the section. | Click **Select** to choose a blog. |
| **Posts to show** | The largest number of posts the section shows. | **2 to 12.** |
| **Posts per row** | How many post cards sit in one row on desktop. | **2 to 6.** |
| **Column gap** | The space between post cards on desktop. | **0 to 50 px.** |
| **Column gap on mobile** | The space between post cards on mobile. | **0 to 30 px.** |
Choose a post count and number of columns that show your posts without crowding the page.
### Card settings
What each post card shows, and how it looks.
| Setting | Description | Options |
| ----------------------- | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Image aspect ratio** | The shape of the image on each card. | **Original aspect ratio**, **1:1**, **3:4**, **4:3**, or **16:9**. |
| **Heading size** | The size of the post title. | **Heading xs**, **Heading sm**, **Heading md**, or **Heading lg**. |
| **Content alignment** | Where the text sits on each card. | **Left**, **Center**, or **Right**. |
| **Show tags** | Shows the post's tags above the title. | **On** or **Off**. |
| **Show publised date** | Shows the date the post was published. | **On** or **Off**. |
| **Show excerpt** | Shows a short preview of the post below the title. | **On** or **Off**.
*If a post has no excerpt, the card shows the start of the post's content. To add an excerpt, open the post in Shopify Admin > **Content** > **Blog posts**.* |
| **Show read more link** | Shows a **Read more** link that opens the post. | **On** or **Off**. |




Show the excerpt to help customers decide which posts to read.
### Button settings
A button that takes customers to another page, such as your full blog.
| Setting | Description | Options |
| ------------------------- | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| **Show button on header** | Where the button sits. | **On**: next to the section heading.
**Off**: below the posts. |
| **Button link** | The page customers go to when they click the button. | Paste a link or search for a page. |
| **Button label** | The text on the button. | Enter text, such as `View More`.
*Leave it blank to hide the button.* |
| **Button style** | How the button looks. | **Primary button**, **Secondary button**, **White button**, **Underline button**, or **Plain button**. |
| **Button size** | The size of the button. | **Button small**, **Button medium**, or **Button large**. |


### Mobile Settings
| Setting | Description | Options |
| ---------------------------- | --------------------------------------------------------------- | ------------------ |
| **Enable horizontal scroll** | Lets customers swipe sideways through the post cards on mobile. | **On** or **Off**. |
Turn on **Enable horizontal scroll** to show several posts on mobile without stacking every card.
Your blog's posts show as cards in the theme editor preview, with the details you turned on.
## Related articles
Common section settings
Blog posts (Other pages)
Blogs