Want to add a hero image to the top of your Botiga site? Botiga supports the core WordPress header image feature, plus display conditions that let you choose exactly which pages show the image.
In this guide, we’ll walk you through how to add a header image in Botiga.
Before you get started, make sure you’ve installed and activated the Botiga theme on your WordPress site. If you’re using features from Botiga Pro, ensure that both the Botiga theme and the Botiga Pro plugin are installed and active.
Uploading Your Header Image
From your admin area, go to Customize >> Header >> Header Image. Under Current Header, click Add New Image, then upload or select an existing image.
Tip: this image will be large, so optimize it before uploading with a service like ShortPixel. Skip this step if you already use an image optimization plugin.
The recommended image size is 1920×500. Once you upload your image, you’ll be prompted to crop it. Use the crop tool or skip it.
Setting Display Conditions
By default, the header image appears on every page. Click Add/Edit Conditions to limit where it shows. For example, display it only on single posts, single pages, WooCommerce pages, or a specific post.
Stack multiple display conditions, add user conditions (such as logged in or logged out), and use the Exclude rule to hide the header from specific pages or users. Click Save Conditions when you’re done, then publish your changes. For deeper detail, see our guide on using display conditions in Botiga.
Frequently Asked Questions
Below, we’ve answered some of the most common questions about adding a header image in Botiga.
What size should my header image be?
The recommended size is 1920×500 pixels. Optimize the file before uploading so it doesn’t slow your site down.
Can I show different header images on different pages?
Yes, through display conditions. Upload separate header images and use the conditions panel to set which pages each one appears on.
Can I hide the header image from logged-in users?
Yes. Add a user condition in the display conditions popup and exclude logged-in users (or include only specific user roles).
That’s it! You’ve successfully added a header image in Botiga.
Next, would you like to fine-tune the rest of your header layout? Check out our guide on using the header and footer builder to learn more.
