The `blog` template renders the blog page, which lists all articles within a blog.

> Tip:
> Refer to the [blog template](https://github.com/Shopify/dawn/blob/main/templates/blog.json) and its [main section](https://github.com/Shopify/dawn/blob/main/sections/main-blog.liquid) in Dawn for an example implementation.

<figure class="figure">
  <img src="/assets/themes/templates/blog.png" style="width: 100%; max-width: 550px;" alt="An example of the blog template in Dawn">
</figure>

## Location

The `blog` template is located in the `templates` directory of the theme:

```text
└── theme
    ├── layout
    ├── templates
    |   ...
    |   ├── blog.json
    |   ...
    ...
```

## Content

Your blog template should contain a section that includes the [`blog` object](#the-blog-object).

### The blog object

You can access the Liquid [`blog` object](/docs/api/liquid/objects/blog) to display the blog details.

## Usage

When working with the `blog` template, you should familiarize yourself with [filtering articles by tag](#filter-articles-by-tag).

> Tip:
> If you're using a JSON template, then any HTML or Liquid code needs to be included in a [section](/docs/storefronts/themes/architecture/sections) that's referenced by the template.


### Filter articles by tag

You can use [article tags](/docs/api/liquid/objects/article#article-tags) to filter a blog into smaller subsets of articles. This is done by appending `/tagged/[tag-handle]` to the blog URL, where `[tag-handle]` is the [handleized](/docs/api/liquid/filters/handleize) version of the desired article tag.

For example, if you want to show only articles from the `main` blog that are tagged with `news`, then you can use the following URL structure:

```text
https://my-store.myshopify.com/blogs/main/tagged/news
```

You can also filter by multiple tags by combining the handleized tags with a `+`:

```text
https://my-store.myshopify.com/blogs/main/tagged/news+breaking
```

> Tip:
> Instead of manually building this URL structure, you can use the [link_to_tag](/docs/api/liquid/filters/link_to_tag), [link_to_add_tag](/docs/api/liquid/filters/link_to_add_tag), and [link_to_remove_tag](/docs/api/liquid/filters/link_to_remove_tag) URL filters.