How to Add a Banner to a Specific WordPress Page

You can display a banner on one WordPress page without showing it across your entire site. The best method depends on whether the banner is simply part of the page content or needs to be controlled by a reusable page template.

Black and white signs representing banner and header design elements

Add a banner directly to one WordPress page

If the banner only needs to appear within one page's content, this is the simplest option and does not require editing theme files:

  1. Go to Pages > All Pages in your WordPress dashboard.
  2. Edit the page where you want the banner to appear.
  3. Add an Image block, a Cover block, or the HTML for your linked banner at the position where it should appear.
  4. Set the image's link destination if visitors should be taken to another page, then add descriptive alternative text when the image conveys information.
  5. Update the page and check the result on desktop and mobile.

This approach is ideal for a one-off banner. It also keeps the banner attached to the page content, so you do not need to maintain a custom PHP template.

Use a custom page template for a targeted banner

If you want a banner inserted automatically in a particular layout, create a custom page template in a child theme. Do not edit the parent theme directly because theme updates can overwrite your changes. The exact template structure varies by theme, so begin with a copy of the active theme's existing page template and preserve its header, content loop, wrappers, and footer.

  1. Back up your site and make sure a child theme is active.
  2. Using SFTP or your hosting file manager, copy the appropriate page template from the parent theme into the child theme. For some classic themes this is page.php; other themes organize templates differently.
  3. At the very top of the copied PHP file, before any output, add a unique template header:
<?php
/*
Template Name: Page with Banner
Template Post Type: page
*/

Keep the rest of the copied template intact. Insert your banner markup inside the existing page layout where you want it to appear. For example:

<div class="page-banner">
  <a href="/your-destination/">
    <img src="/wp-content/uploads/your-banner.webp"
         alt="Brief description of the banner">
  </a>
</div>
  1. Save the new PHP file in the child theme using a distinct filename, such as page-with-banner.php.
  2. In the WordPress dashboard, edit the page that should use the banner.
  3. In the page settings sidebar, find Template and select Page with Banner.
  4. Update the page and verify the banner placement, link, and responsive behavior.

Important: Do not replace the entire theme page template with only the banner snippet. The template must still render the page content and the theme's normal layout. Test the new template on a staging site when possible.

What if you use a block theme?

Block themes use templates managed through Appearance > Editor > Templates. You can create or customize a page template there and add an Image, Cover, or other banner block. The Site Editor workflow is different from the PHP template method used by classic themes.

Which method should you use?

  • One banner on one page: Add the image or banner block directly to that page.
  • A reusable layout for selected pages: Use a custom page template in a child theme, or a suitable block theme template.
  • The same banner on many pages: Consider a reusable pattern, synced pattern, or a carefully targeted theme hook rather than maintaining duplicate markup.

For more information about page templates, see the official WordPress template hierarchy documentation.

By Lance, Provider of Simple Solutions | 3 min read