> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://help.ecomx.co/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # Shine Blog Post List **Theme:** Shine ยท **Section type:** All-template section The Blog post list section shows the latest posts from one of your blogs as a grid or a carousel. Use it on your homepage or any page to bring customers to your stories, guides, and news. > **Note:** You can add this section to any template, except the header and footer. It shows from 2 to 12 posts. ![Blog post list section on the Ardent homepage (large screen)](https://storage.crisp.chat/users/helpdesk/website/-/f/8/b/b/f8bb8da391016800/shine-blog-post-list-1_1endjh2.jpg) **What you can do** - Add the section and choose a blog - Choose what each post card shows - Choose the layout on large screens and phones - Add a button to the blog page - See what customers see - Look up every setting in "Settings reference" - Fix common problems --- ## Add the section and choose a blog 1. In the theme editor, open the template where you want the section. 2. In the left sidebar, click **Add section** > **Blog post list**. 3. Under **General**, click **Blog** and select the blog to show. 4. Drag **Maximum items to show** to set how many posts appear, from 2 to 12. 5. Enter a **Section subheading**, **Section heading**, and **Section description**, or leave them empty. 6. Click **Save**. > **Tip:** To highlight part of the heading, put it between square brackets, for example "Notes from the \[bench]". You choose the highlight style in **Theme settings** > **Typography**. ## Choose what each post card shows 1. Click the **Blog post list** section. 2. Under **Blog post card**, check what each card shows: **Show featured image**, **Show blog's tags**, **Show published date**, **Show author**, and **Show excerpt**. 3. Click **Save**. > **Note:** The card style, card color scheme, and image ratio are theme settings. They apply to every blog post card in your store. To change them, click **Theme settings** > **Blog post card** and choose a **Style** (Standard or Card), a **Color schemes** option, and an **Image ratio** (Square or Landscape). ## Choose the layout on large screens and phones 1. Click the **Blog post list** section. 2. Under **Large screen**, choose a **Section heading position**: Top left, Top center, or Inline. 3. Choose a **List style**: Grid or Carousel. 4. Choose the **Columns per row**: 3, 4, or 5. 5. Under **Mobile screen**, choose a **Section heading position** (Top left or Top center) and a **List style** (Grid or Carousel). 6. Click **Save**. ## Add a button to the blog page 1. Click the **Blog post list** section. 2. Under **Button**, check **Enable 'View all' button**. 3. Enter a **Label**, for example "Explore more". 4. Choose a **Style**: Filled, Outlined, or Text link. 5. Click **Save**. The button opens the page of the blog you selected under **General**. ## What customers see - **Post cards:** each card shows the parts you turned on: the featured image, the tags, the title, the author and date, and the excerpt. Customers click the image or the title to open the post. - **Carousel:** on large screens, customers use the arrow buttons to scroll through the posts. On phones, they swipe. - **Grid:** large screens show the number of columns you chose. Phones show 1 post per row, and tablets show 2. - **Inline heading:** with Inline, the heading, description, and button sit in a column to the left of the posts. - **Button:** with Top left or Top center, the button appears below the posts. - **No blog selected:** the section shows sample cards until you select a blog. ![Blog post list on a phone, shown as a grid (Ardent homepage)](https://storage.crisp.chat/users/helpdesk/website/-/f/8/b/b/f8bb8da391016800/shine-blog-post-list-2_1px8ya0.jpg) ## Settings reference ### General | Setting | What it does | | ---- | ---- | | Color schemes | Sets the background and text colors of the section. You edit color schemes in Theme settings > Colors. | | Section subheading | Adds a short line of text above the heading. | | Section heading | Adds the section heading. Put words between [ and ] to highlight them. | | Heading size | Sets the heading size: H2, H3, H4, or H5. | | Section description | Adds text below the heading. | | Blog | Selects the blog whose posts appear. | | Maximum items to show | Sets how many of the latest posts appear, from 2 to 12. | ### Blog post card | Setting | What it does | | ---- | ---- | | Show featured image | Shows the post's featured image. | | Show blog's tags | Shows the post's tags above the title. | | Show published date | Shows the date the post was published. | | Show author | Shows the author of the post. | | Show excerpt | Shows the post's excerpt. You add the excerpt in each blog post in the Shopify admin. | ### Large screen | Setting | What it does | | ---- | ---- | | Section heading position | Places the heading at Top left or Top center above the posts, or Inline beside them. | | List style | Shows the posts in a Grid or a Carousel. | | Columns per row | Shows 3, 4, or 5 posts per row. | ### Mobile screen | Setting | What it does | | ---- | ---- | | Section heading position | Places the heading at Top left or Top center above the posts. | | List style | Shows the posts in a Grid (1 post per row) or a Carousel that customers swipe. | ### Button | Setting | What it does | | ---- | ---- | | Enable 'View all' button | Shows a button that opens the blog page. | | Label | Sets the button text. If empty, the button shows "View all". | | Style | Sets the button style: Filled, Outlined, or Text link. | ## Troubleshooting **The section shows sample posts instead of my blog posts.** Select a blog under **General** > **Blog**. Check that the blog has published posts. **The excerpt doesn't show.** The card shows the excerpt only when the post has one. In the Shopify admin, open the blog post and add text in the **Excerpt** box. Also check that **Show excerpt** is on. **The 'View all' button doesn't show.** Check that **Enable 'View all' button** is on. The button appears only when the section has a subheading, heading, or description. **I can't find the image ratio setting.** The image ratio is now a theme setting. Click **Theme settings** > **Blog post card** > **Image ratio**. ## Related articles - [Shine Blog Page](https://doc.ecomx.co/en/article/shine-blog-page-1alhk0l/) - [Shine Blog Post Details](https://doc.ecomx.co/en/article/shine-blog-post-details-cev8ve/) - [Shine Theme Settings](https://doc.ecomx.co/en/article/shine-theme-settings-1876q8v/) - [Shine Typography](https://doc.ecomx.co/en/article/shine-typography-6k6p3o/)