How to set Image Focal Points in Wagtail

This video is from Wagtail CMS 2025 .

How to set Image Focal Points in Wagtail
0:04:02
Published March 11, 2025
324 views

Our latest Wagtail trick shows you how to use focal points to make images look good across your Wagtail site no matter how many times you reuse them. Watch on to see how to use the focal point feature in your Wagtail image library to help make your images looking amazing.

If you want more Wagtail tips and tricks, sign up for our newsletter here: https://wagtail.org/newsletter/?utm_source=youtube&utm_medium=social&utm_campaign=quarter-1-2025

💻 Wagtail is the easiest open-source Python CMS to use:
Install the demo and start building your first site in 10 minutes: https://wagtail.org/get-started/

What will I learn from this video?

You will learn how to set focal points for images in Wagtail CMS. This feature in the image library helps editors make their images look great even if they are reusing them in different shapes and sizes across their website.

📹 Related Videos To Watch Next:

â–¶ How to Use the Wagtail Starter Kit https://youtu.be/5MAwXoDE_ws?feature=shared
â–¶ The Latest on Wagtail AI https://www.youtube.com/watch?v=4zfs1u4Vy5Y
â–¶ How to Clean Up Your Wagtail User Accounts https://youtu.be/BTWCLBYtPYk?feature=shared

Wagtail future proofs your CMS system, as it’s open source, continuously updated and built on Python, one of the most popular global programming languages, used widely in machine learning and big data. So you’re always ahead of the curve when it comes to CMS platforms.

Wagtail is the #1 choice for accessibility, is scalable and most importantly, secure.

👉 Get started with a FREE Wagtail CMS TRIAL: https://wagtail.org/get-started/
and see how easy it is to build a website that works for you.

📊 Read why Google, NASA, and the British NHS, are powering their digital estates with Wagtail: https://wagtail.org/about-wagtail/

🎥 More Wagtail Videos: https://www.youtube.com/watch?v=cne2kxemMAQ&list=PLfwZ-fob20cPvSQ_v1hkjto8BAPN21tLJ

📣 Follow us on social:

#WagtailCMS #Django #content #contentcreation #images

Summary

When the same image is reused in different layouts—such as full-width, rectangular, or square crops—automatic cropping can place attention on the wrong part of the photo. Wagtail’s focal point feature lets editors mark the important area of an image so crops remain useful across the site. Using a baking-soda image as an example, Megan selects and sizes the focal area around the scoop and some surrounding baking soda, saves the image, and refreshes the page to show the improved square crop.

Key takeaways

  • Images reused in different layouts need a focal point so automatic crops focus on the intended subject.
  • In Wagtail, editors can set a focal point by highlighting the important area directly on the image.
  • The focal area should be kept small enough to work well at smaller image sizes.
  • Saving the focal point updates how the image is cropped throughout the site.

Summarised automatically from the transcript.

Transcript

708 words · auto-generated Show

Automatically transcribed, so expect mistakes in names and technical terms.

0:00

Hello everyone, Megan here. I got another Wagtail trick for you today. I'm gonna show you how to set focal points on your image. And why do focal points matter? Well, let's have a look at this website here, which is the Wagtail Bakery Demo. As we scroll through the page, you can see that there are lots of different shapes of images. We have some that stretch all the way across the screen, there are some that are squares, there are some that are rectangles. And I'm sure if we let our CSS folks go a little nuts, they probably would create things like stars or circles or amorphous blobs. The point being that when you reuse images in different places, you need to make sure that they all look good despite their different shapes

0:49

And so if we scroll, keep scrolling down here to our blog area, you'll notice that in the blog posts we've had listed here. That these images look pretty okay, but there seems to be something going on here, and this also seems to be slightly out of alignment, but we're not gonna worry about that right now. We're gonna worry more about what is going on here. It looks like this is not in the right location. Let's go ahead and click in and see if we can get an idea what the image is supposed to be And as you can see, it looks like we this picture is supposed to be of a bowl of baking soda with a scoop in it. Which looks pretty much fine on the blog post page itself here

1:36

with it stretched all the way across the page but if you know we go back to this square cropping here it looks a little funny uh and this is where focal points come in Because it's important to make sure that no matter where the image appears on your site, that it focuses on the right part of the photo. Alright, so I'm gonna go ahead and go into our dashboard here for the site. I'm gonna go to images and I'm gonna find our baking soda image in our image. library here. Alright, so here is our baking soda image. And you can see, yeah you probably saw it briefly, there was a square over there and that's because I cheated a little bit. I went ahead and set a bad focal point so that I could show you guys how this works.

2:23

But let's assume I didn't do that and that it was just kind of some bad luck with the cropping. So we can set a new focal point mostly by just going to the image here and just highlighting the place where we want people to focus on the image. And I think uh that the area that would be best to focus on is generally the scoop area. Uh so I'm gonna go ahead and just just kind of highlight this area here. You might want to make the it a little bit smaller just in case things need to be like a smaller size image. So I think I'm gonna go ahead and make this a bit smaller and focus on kind of the scoop area so that we get some of the baking soda in with a scoop it makes for a nice little bit of contrast.

3:10

Alright, so I'm gonna go ahead and that's set. Uh it and I'm gonna go ahead and save this here. And that has been updated. So let's go back to the page and let's go ahead and refresh everything and see if it looks Looks a bit better. Aha! There we go! As you can see, it now looks much better than it did before. And that's how you can use focal points to make your images look great across different places on the site Alright, I hope that was useful for you. If you would like to learn more Wagtail tips and tricks from me, please subscribe to our YouTube channel or go ahead and sign up for our newsletter. I also send out regular tips through there as well.

3:55

You can find it at Wagtail. org slash newsletter.

Questions this talk answers

Why do focal points matter in Wagtail images?

Focal points keep the important part of an image visible when the same image is cropped into different shapes and sizes across a site.

Discussed at 1:36

How do I set a focal point on an image in Wagtail?

Open the image in the Wagtail dashboard, select the area viewers should focus on—such as the scoop in the baking-soda photo—adjust the selection if needed, and save the image.

Discussed at 2:23

Note: We understand that names change, people change, and bodies change. We respect each individual's journey and privacy. If you have any concerns about a video or need us to remove content, please don't hesitate to contact us. We will handle your request with care and promptly address any issues.

More videos from Wagtail CMS