Back to Community
Home / Community / Theme → Onepress

Troubleshooting the OnePress Hero Section: Common Issues and Solutions

25 threads Sep 9, 2025 Theme → Onepress

Content

The Hero section is a central feature of the OnePress theme, designed to create a striking first impression on your homepage. However, users often encounter specific, recurring problems when setting it up or customizing it. Based on community discussions, here are the most common Hero section issues and how to resolve them.

1. Hero Section is Not Visible or Configurable

The Problem: The Hero section and its settings do not appear in the WordPress Customizer.

Why It Happens: This is almost always because the site's homepage has not been configured correctly. The OnePress theme sections, including Hero, are designed to work specifically on a static front page.

The Solution:

  1. In your WordPress dashboard, go to Settings > Reading.
  2. Set 'Your homepage displays' to 'A static page'.
  3. Select the page you want to use as your homepage from the dropdown menu.
  4. This page must use the 'Front Page' template. You can set this by editing the page and selecting the template from the 'Page Attributes' meta box.

Once this is done, the Hero section and other front page sections should become available in the Customizer.

2. Hero Section Appears Twice (Duplication)

The Problem: After an update, the entire Hero section is duplicated on the homepage.

Why It Happens: This is a known compatibility issue that can occur when the main OnePress theme is updated but an associated 'OnePress Plus' extension plugin is not. An outdated Plus plugin can cause conflicts and render sections twice.

The Solution:

  • If you use the OnePress Plus extension, ensure it is updated to the latest version compatible with your theme. This typically requires an active license key.
  • If your license has expired and you cannot update, you may need to temporarily roll back the main OnePress theme to a previous version using a plugin like 'WP Rollback' to restore compatibility until you can update the Plus plugin.

3. Text or Shortcodes Not Working in Hero

The Problem: Text changes in the Hero content settings are not saved, or shortcodes (e.g., [shortcode]) are displayed as plain text instead of functioning.

Why It Happens: This can be caused by a plugin conflict, a browser or site cache storing old data, or a theme function that does not process shortcodes in that specific area.

The Solution:

  1. Clear Caches: Clear any site caching (from plugins or your host) and your browser cache.
  2. Conflict Test: Temporarily deactivate all plugins. If the problem is resolved, reactivate them one by one to identify the culprit.
  3. Shortcode Specifics: The Hero section may not automatically process shortcodes. To execute a shortcode, you would need to add custom code to your child theme's section-hero.php template file, using the WordPress do_shortcode() function. This requires comfort with editing theme files.

4. Hero Section Only Shows on Homepage

The Problem: The Hero section is designed only to display on the static front page and disappears on all other pages.

Why It Happens: This is the intended default behavior of the OnePress theme, not a bug. The theme's architecture loads sections specifically for the front page template.

The Solution: Displaying the Hero on other pages is not natively supported in the free version. Workarounds are complex and require significant customization, such as creating a custom page template that manually loads the Hero section, which is outside the scope of standard theme support.

5. Hiding the Hero Section on Mobile Devices

The Problem: The large Hero section does not display well on small mobile screens.

The Solution: You can easily hide it using CSS.

  1. In the WordPress Customizer, navigate to Additional CSS.
  2. Paste the following code: 
    @media (max-width: 699px) {
    #hero { 
        display: none; 
    }
}
  3. Publish the changes. This will hide the Hero section on screens smaller than 700px wide.

For issues related to features explicitly stated as exclusive to the Plus version (like adding more than two background images or using photos instead of icons in sections), the solutions are only available through the premium offering. The official 'OnePress' documentation is a valuable resource for setup instructions and understanding the theme's capabilities.

Related Support Threads Support