GridHub Documentation

GridHub is a clean and modern, responsive grid WordPress theme for writers or bloggers. It is designed to display content in a beautiful grid layout, making it ideal for gallery blog websites. GridHub features a 5-column posts grid, 2 navigation menus, a header image, sticky menu and sticky sidebars, a 6-column footer, social media icons, author image support, a right sidebar, full-width custom page/post templates, and many options. GridHub theme also has RTL language support and a translation-ready codebase. The theme is very starter-friendly and easy to set up.

Method 1: Install via WordPress Dashboard (Recommended)

1. Log in to your WordPress Dashboard.
2. Navigate to Appearance → Themes → Add New.
3. Search for GridHub in the search box.
4. Click Install on the GridHub theme, then click Activate.

Method 2: Upload via WordPress Dashboard

1. Download the gridhub.zip theme file from WordPress.org.
2. Log in to your WordPress Dashboard.
3. Navigate to Appearance → Themes → Add New → Upload Theme.
4. Click Choose File, select the gridhub.zip file, and click Install Now.
5. After installation, click Activate.

Method 3: Upload via FTP/File Manager

1. Download the gridhub.zip theme file and extract it.
2. Connect to your server via FTP (FileZilla) or use your hosting File Manager.
3. Upload the extracted gridhub folder to /wp-content/themes/.
4. Go to your WordPress Dashboard → Appearance → Themes and activate GridHub.

You can import the demo content, widgets, and Customizer settings shown in the GridHub theme demo.

If your website already has existing posts with featured images, it's highly recommended to regenerate thumbnails after activating the GridHub theme. This ensures that all images match the new theme's layout and display sizes.

Regenerating thumbnails is optional if your site is completely new and doesn't have any uploaded images yet.

However, if you imported the demo content, regenerating thumbnails is essential to display images correctly across the site.

1. Install and activate the Regenerate Thumbnails plugin.
2. Go to Tools → Regenerate Thumbnails.
3. Click the "Regenerate Thumbnails for All x Attachments" button to start the process.
4. Wait until all images are regenerated. This may take a few minutes depending on your media library size.
5. If you want, you can deactivate and delete the plugin once the process is complete.

This step ensures clean image alignment and sharp visuals throughout your website using the GridHub theme.

GridHub supports a custom Header Image that appears at the very top of your website, above the header content and navigation menus. You can upload any image, link it to a URL, and overlay custom title/description text.

How to Set Up the Header Image

1. Go to Appearance → Customize → Theme Options → Header Image.
2. Click Add New Image and upload your header image.
3. Use the Theme Options → Header Options section to further customize header elements.

Header Image Options

Under Appearance → Customize → Theme Options → Header Options, you can:

• Hide Header Image – Hide the header image everywhere.
• Remove Header Image Link – Make the header image non-clickable.
• Hide Header Image Details – Hide both the title and description overlay on the header image.
• Hide Header Image Description – Hide only the description overlay.
• Enable Custom Title/Description – Turn on custom overlay text for the header image.
• Header Image Custom Title – Set a custom overlay title.
• Header Image Custom Description – Set a custom overlay description.
• Header Image Destination URL – Set a custom URL for the header image link (defaults to homepage if left empty).

This theme includes two Display Locations for menus: Primary Menu, and Secondary Menu.

Right after installing the theme, WordPress may display your existing pages as the default menu items in these locations. You can replace them with your own custom menus containing links, categories, pages, and more by following the steps below:

1. Go to Appearance → Menus and click the create a new menu link.
2. Enter a name for your menu in the Menu Name field.
3. Select a display location for your menu by checking one of the available options under Display location
4. Click the Create Menu button.
   
5. To add items to the menu, use the options in the left-hand column—select the pages, posts, categories, or tags you want, then click Add to Menu.
6. To create dropdown menus, simply drag and nest the submenu items beneath the parent menu item.
7. Once you've added your links, click the Save Menu button.

GridHub displays your latest posts in a beautiful 5-column grid layout on the homepage. Each grid item shows the post thumbnail, title, author image, date, categories, and a post snippet.

Setting Up the Posts Grid

To display your latest posts as a grid on your homepage, set the "Your homepage displays" option to "Your latest posts". You can find this setting in your WordPress Dashboard by navigating to Settings → Reading → Your homepage displays.

Grid Customization Options

Under Appearance → Customize → Theme Options → Posts Grid Options, you can customize:

• Center the Content of Grid Items – Center-align text within each grid item.
• Hide Posts Heading – Hide the "Recent Posts" heading above the grid.
• Posts Heading – Change the heading text (default: "Recent Posts").
• Posts Per Page – Control how many posts are displayed per page.
• Auto Post Summary Length – Set the number of words in each post snippet (default: 15).
• Read More Text – Customize the "read more" link text.
• Hide Post Author Images – Hide the author avatar from grid items.
• Author Image Link – Link the author image to the author’s posts page.
• Hide Post Titles – Hide post titles from the grid.
• Hide Posted Dates – Hide dates from the grid.
• Hide Post Authors – Hide author names from the grid.
• Hide Post Categories – Hide category links from the grid.
• Hide Post Tags – Hide tag links from the grid.
• Hide Comment Links – Hide comment count links from the grid.
• Hide Thumbnails – Hide featured images from the grid.
• Hide Default Thumbnail – Hide the placeholder image when no featured image is set.
• Hide Post Snippets – Hide the post excerpt/summary from the grid.

GridHub includes 18 widget areas that allow you to add widgets (e.g., Recent Posts, Search, Custom HTML, etc.) to different parts of your website. You can manage your widgets by going to Appearance → Widgets.

GridHub includes custom page/post templates to give you layout flexibility:

• Full Width Page (template-full-width-page.php) – A page template without a sidebar, the content spans the full width.
• Full Width Post (template-full-width-post.php) – A post template without a sidebar, the content spans the full width.

How to Use a Page Template

1. Edit or create a Page in your WordPress Dashboard.
2. In the right sidebar, look for the Page Attributes section (or Template option in the block editor).
3. Select the desired template from the Template dropdown.
4. Click Publish or Update.

How to Use a Post Template

1. Edit or create a Post in your WordPress Dashboard.
2. In the right sidebar, look for the Post Attributes section (or Template option in the block editor).
3. Select the desired template from the Template dropdown.
4. Click Publish or Update.

GridHub provides extensive customization options through the WordPress Customizer. You can access these options by going to Appearance → Customize.

The theme options are organized under the "Theme Options" panel. Below is a detailed reference for every available option.

GridHub is fully translation-ready and supports Right-to-Left (RTL) languages like Arabic, Hebrew, and Persian out of the box.

🌐 Translating the Theme

The theme includes a gridhub.pot file located in the /languages folder inside the theme directory. You can use this file to create translations in your own language using any of the following tools:

• Poedit – Desktop translation editor (view tutorial)
• Loco Translate – Translate the theme directly from your WordPress dashboard (view tutorial)

After translating, save your files as:

• gridhub-[language_code].po
• gridhub-[language_code].mo

Place them inside the /languages folder in the theme.

↔️ RTL Language Support

GridHub includes built-in RTL support. If your WordPress site language is set to an RTL language, the theme will automatically adjust layout direction, alignment, and spacing accordingly. No extra setup required.

If you're customizing your site with RTL content, make sure your text widgets, menus, and custom styles are also RTL-compatible for best results.

Here are some tips to optimize your GridHub-powered website for speed and search engine visibility:

• Use a Caching Plugin – Install a caching plugin like W3 Total Cache, WP Super Cache, or LiteSpeed Cache to improve page load times.
• Optimize Images – Use plugins like Imagify, Smush, or ShortPixel to compress images without losing quality.
• Use a CDN – A Content Delivery Network (CDN) like Cloudflare speeds up your site by serving content from servers closest to your visitors.
• Install an SEO Plugin – Use Yoast SEO or All in One SEO to optimize your content for search engines.
• Keep WordPress Updated – Always use the latest versions of WordPress, themes, and plugins for performance and security improvements.
• Minimize Plugins – Only use plugins you truly need. Too many plugins can slow down your site.
• Use Quality Hosting – Choose a reliable hosting provider that offers good performance, such as SiteGround, Cloudways, or Bluehost.
• Enable GZIP Compression – Most caching plugins include this feature, or you can enable it via your hosting panel.
• Set Featured Images – Always set a featured image for your posts. The recommended size for grid thumbnails is at least 480×360 pixels. For full-width content, use at least 1292 pixels wide.
• Regenerate Thumbnails – After switching themes, regenerate thumbnails to ensure images display correctly.

Q: How do I set up the posts grid on the homepage?

A: Go to Settings → Reading and set "Your homepage displays" to "Your latest posts". The grid layout will automatically display your latest posts. You can customize the grid options under Appearance → Customize → Theme Options → Posts Grid Options.

Q: How do I change the number of posts displayed per page?

A: Go to Appearance → Customize → Theme Options → Posts Grid Options and change the "Posts Per Page" value. If this field is empty, it will use the WordPress default value from Settings → Reading → "Blog pages show at most".

Q: How do I add social media icons?

A: Go to Appearance → Customize → Theme Options → Social Links Options. Enter the full URL of your social profiles in the corresponding fields. Icons will appear automatically in the menu area. You can choose which menu (Primary or Secondary) displays the icons using the "Social + Search + Login/Logout Buttons Location" option.

Q: How do I set up a custom logo?

A: Go to Appearance → Customize → Theme Options → Site Identity and click "Select logo" to upload your logo image.

Q: How do I use the full-width page template?

A: Edit a page, then in the right sidebar look for the "Template" option (in the block editor) or "Page Attributes" section (in the classic editor). Select "Full Width Page" from the dropdown.

Q: How do I use numbered pagination?

A: Install and activate the WP-PageNavi plugin. Then go to Appearance → Customize → Theme Options → Post/Posts Navigation Options and select "Numbered Navigation" from the "Posts Navigation Type" dropdown.

Q: How do I change the footer copyright text?

A: Go to Appearance → Customize → Theme Options → Footer Options and enter your custom text in the "Footer Copyright Notice" field. HTML is allowed.

Q: How do I hide the author image from grid items?

A: Go to Appearance → Customize → Theme Options → Posts Grid Options and check "Hide Post Author Images from Posts Grid".

Q: How do I disable the loading animation?

A: Go to Appearance → Customize → Theme Options → Other Options and check "Disable Site Loading Animation".

Q: Can I use the classic widget editor instead of the block editor?

A: Yes. Go to Appearance → Customize → Theme Options → Other Options and make sure "Enable Gutenberg Widget Block Editor" is unchecked.

Q: Where can I choose where social buttons appear?

A: Go to Appearance → Customize → Theme Options → Social Links Options. Use the "Social + Search + Login/Logout Buttons Location" dropdown to choose between "Primary Menu" and "Secondary Menu".

Images are not displaying correctly or are cropped oddly

After activating GridHub (or any new theme), you should regenerate thumbnails so that existing images are resized to match the theme's image dimensions. Install the Regenerate Thumbnails plugin and run it from Tools → Regenerate Thumbnails.

The grid layout is not showing on the homepage

Make sure your homepage is set to display your latest posts. Go to Settings → Reading and set "Your homepage displays" to "Your latest posts". If you're using a static page as your homepage, the grid layout will not appear on that page.

Menus are not showing

Make sure you've created a menu and assigned it to a display location. Go to Appearance → Menus, create or select a menu, and check the appropriate location (Primary Menu or Secondary Menu) under "Menu Settings". Also, check that the menu is not disabled in Appearance → Customize → Theme Options → Menu Options.

Social icons are not appearing

Ensure that you've entered at least one social profile URL in Appearance → Customize → Theme Options → Social Links Options. Also check that "Hide Social/Search/Login-Logout Buttons" is not checked. Verify the "Social + Search + Login/Logout Buttons Location" setting matches the menu you're looking at.

Header image is not showing

Go to Appearance → Customize → Theme Options → Header Image and make sure an image is uploaded. Also check that "Hide Header Image" is not checked in Appearance → Customize → Theme Options → Header Options, and that "Hide Header Content" is also not checked.

Footer widgets are not displaying

Make sure you've added widgets to the footer widget areas via Appearance → Widgets. Also check that "Hide Footer Widgets" is not checked in Appearance → Customize → Theme Options → Footer Options.

Theme options changes are not saving

Make sure you click the "Publish" button at the top of the Customizer after making changes. If the issue persists, try clearing your browser cache, deactivating other plugins to check for conflicts, or contacting your hosting provider about PHP memory limits.

Numbered pagination is not working

Make sure the WP-PageNavi plugin is installed and activated. Then go to Appearance → Customize → Theme Options → Post/Posts Navigation Options and select "Numbered Navigation".

The GridHub theme is released under the GNU General Public License v2.0 (GPL v2). You can use the theme on unlimited websites and modify the code.

What's included in free support:

• Help with theme installation and setup
• Bug fixes and troubleshooting related to the theme
• Guidance on using built-in theme features

What's not included in free support (but available as paid tasks):

• Theme customization or resolving third-party plugin conflicts
• Custom coding or feature implementation requests
• Performance tuning, SEO setup, or server configuration assistance

If you need help, please contact us. We typically respond within 24-48 hours on working days.

Contact Support

Upgrade to GridHub PRO

For more features including color options, font options, news ticker, related posts, and much more, consider upgrading to GridHub PRO.

You can use the following date format values to control how dates appear in various places such as custom widgets, post metadata, news tickers, and more. These formats follow the standard PHP date formatting rules used by WordPress. Refer to the table below to choose a format that best fits your design and content style.