---
title: 'Post with a Background Image'
url: 'https://demo.getgrav.org/hpstr-skeleton/blog/background-image'
markdown: 'https://demo.getgrav.org/hpstr-skeleton/blog/background-image.md'
date: '2013-10-27'
description: 'Here be a sample post with a custom background image. To utilize this "feature" just add the following YAML to a post''s front matter. image: background: filename.png This little bit of YAML makes the assumption that your background image asset is in the /images folder. If you place it somewhere e…'
taxonomy:
  tags:
    - 'sample post'
---

# [Post with a Background Image](https://demo.getgrav.org/hpstr-skeleton/blog/background-image "Post with a Background Image")

## October 27, 2013

  Reading time ~1 minute

Here be a sample post with a custom background image. To utilize this "feature" just add the following YAML to a post's front matter.

```yaml
image:
  background: filename.png
```

This little bit of YAML makes the assumption that your background image asset is in the `/images` folder. If you place it somewhere else or are hotlinking from the web, just include the full http(s):// URL. Either way you should have a background image that is tiled.

If you want to set a background image for the entire site just add `background: filename.png` to your `_config.yml` and BOOM --- background images on every page!

Background images from Subtle Patterns ([Subtle Patterns](http://subtlepatterns.com)) / [CC BY-SA 3.0](http://creativecommons.org/licenses/by-sa/3.0/)

  [sample post](https://demo.getgrav.org/hpstr-skeleton//tags:sample%20post "Pages tagged sample post")  [Post with a Background Image](https://demo.getgrav.org/hpstr-skeleton/blog/background-image "Post with a Background Image") was published on October 27, 2013 (revised: 10/24/2026) [Joe Bloggs](https://demo.getgrav.org/about "About Joe Bloggs")- [ Like](https://www.facebook.com/sharer/sharer.php?u=https://demo.getgrav.org/hpstr-skeleton/blog/background-image "Share on Facebook")
- [ Tweet](https://twitter.com/intent/tweet?text=https://demo.getgrav.org/hpstr-skeleton/blog/background-image "Share on Twitter")
- [ +1](https://plus.google.com/share?url=https://demo.getgrav.org/hpstr-skeleton/blog/background-image "Share on Google Plus")

   [comments powered by Disqus](http://disqus.com) Read More 

### [Syntax Highlighting Post](https://demo.getgrav.org/hpstr-skeleton/blog/code-highlighting-post "Syntax Highlighting Post")

Demo post displaying the various ways of highlighting code in Markdown. [Continue reading](https://demo.getgrav.org/hpstr-skeleton/blog/code-highlighting-post)

#### [Sample Link Post](https://demo.getgrav.org/hpstr-skeleton/blog/sample-link-post "Sample Link Post")

 Published on August 12, 2013 

#### [A Post with a Video](https://demo.getgrav.org/hpstr-skeleton/blog/video-post "A Post with a Video")

 Published on June 25, 2013

---

## Navigation

- Parent: [Latest Posts](https://demo.getgrav.org/hpstr-skeleton/index.md)
- Next: [Syntax Highlighting Post](https://demo.getgrav.org/hpstr-skeleton/blog/code-highlighting-post.md)
