Documentation - NeatMag WordPress Theme

Introduction

NeatMag is an elegant, flexible, fully responsive 2-column magazine and blogging theme for WordPress. It features theme options to customize various aspects of the theme, beautiful post summaries, full-width custom post/page templates, a sticky menu and sticky sidebars, a header banner widget, a right sidebar, a 4-column footer, social buttons, a scroll-to-top button, and more. The theme is very starter-friendly and easy to set up.

Download Theme Live Demo Upgrade to PRO

Quick Start Guide

Install & activate the theme via Appearance → Themes → Add New.
Set up your menu by going to Appearance → Menus. Create a menu and assign it to the available menu location.
Configure widgets by going to Appearance → Widgets. Add widgets to the available widget areas.
Customize by going to Appearance → Customize → Theme Options. Set up your social links, header options, post options, and more.

Theme Features

Responsive Design
2-Column Magazine Layout with Right Sidebar
Sticky Menu and Sticky Sidebars
1 Navigation Menu (Primary)
Header Banner Widget Area
Multiple Full-Width Widget Areas
4 Footer Widget Columns
30 Social Profile Links
Custom Logo Support
Custom Header Image
Custom Background
Author Bio Box
Full-Width Templates for Posts and Pages
List and Full Post Styles
Translation Ready
Back to Top Button
Loading Animation
FitVids.JS for Responsive Videos
Google Fonts (Playfair Display, Domine, Oswald, Poppins)

Theme Installation

Requirements: WordPress 5.0 or newer and PHP 7.2 or newer. NeatMag is tested up to WordPress 6.8.

Method 1: Install via WordPress Dashboard (Recommended)

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

Method 2: Upload via WordPress Dashboard

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

Method 3: Upload via FTP/File Manager

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

Troubleshooting Installation Issues

"The uploaded file exceeds the upload_max_filesize directive" – Your hosting limits file uploads. Increase the limit via php.ini, .htaccess, or contact your host. Alternatively, use FTP.
"The package could not be installed. The theme is missing the style.css stylesheet" – You may be uploading the wrong file. Make sure you upload only the neatmag.zip file.

Import Demo Content

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

Manual Demo Import

Step 1: Import Main Site Content

This includes: Posts, pages, menus, media, categories, tags, comments, and custom fields.

Download: XML File
Go to Tools → Import.
Under "WordPress", click Install Now if not installed.
Click Run Importer.
Select the XML file and click Upload file and import.
Check "Download and import file attachments", click Submit.

Step 2: Import Widgets

Install the Widget Importer & Exporter plugin.
Go to Tools → Widget Importer & Exporter.
Copy content from: Widgets .wie File and paste into the box.
Click Import Widgets.

Step 3: Import Customizer Settings

Download: Customizer File
Install the Customizer Export/Import plugin.
Go to Appearance → Customize → Export/Import.
Select the .dat file, check "Download and import image files?", click Import.

Regenerate Thumbnails

If your website already has existing posts with featured images, it's highly recommended to regenerate thumbnails after activating the NeatMag 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.

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

NeatMag generates the following featured image thumbnail sizes (hard crop): 1066 × 533 (large), 728 × 364 (featured), 480 × 360 (medium), and 100 × 100 (mini). The content area is 729px wide (1066px in full-width templates), so upload featured images at least 1066px wide for the sharpest display.

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

Header Image

Use the WordPress Customizer to add or manage the header image that appears at the top of your site.

How to add a header image

Go to Appearance → Customize → Header Image.
Click Add new image and choose/upload your image (recommended width: 1086px or larger).
Crop if prompted, then click Publish.

The header image is displayed at the top of your site, above the site logo and header banner area. If no custom logo is set, the site title and description are shown in the header content area below the header image. The header image is linked to your site's homepage.

Navigation Menus

This theme includes one Display Location for menus: Primary Menu.

Right after installing the theme, WordPress may display your existing pages (with a leading "Home" link) as the default menu items in this location. You can replace them with your own custom menu containing links, categories, pages, and more by following the steps below:

Go to Appearance → Menus and click the create a new menu link.
Enter a name for your menu in the Menu Name field.
Select a display location for your menu by checking one of the available options under Display location
Click the Create Menu button.
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.
To create dropdown menus, simply drag and nest the submenu items beneath the parent menu item.
Once you've added your links, click the Save Menu button.

Widget Areas

There are 12 widget areas in the NeatMag theme. The free version does not bundle custom widgets; use WordPress core widgets or plugins of your choice inside these areas.

Header Banner

Widget area located in the header of the web page, next to the logo/site title.
Main Sidebar

Right-hand sidebar for your pages/posts.
Top Full Width Widgets (Home Page Only)

Full-width area after the header, shown only on the homepage (latest posts).
Top Full Width Widgets (Every Page)

Full-width area after the header, shown on every page.
Top Widgets (Home Page Only)

Above main content (above posts), shown only on the homepage (latest posts).
Top Widgets (Every Page)

Above main content (above posts), shown on every page.
Bottom Widgets (Home Page Only)

Below main content (below posts), shown only on the homepage (latest posts).
Bottom Widgets (Every Page)

Below main content (below posts), shown on every page.
Footer 1

Footer column 1.
Footer 2

Footer column 2.
Footer 3

Footer column 3.
Footer 4

Footer column 4.

Page Templates

NeatMag includes two custom templates you can use for full-width layouts without sidebars.

Full Width, no sidebar (Page) — Template for pages (template-full-width-page.php)
Full Width, no sidebar (Post) — Template for posts (template-full-width-post.php)

How to apply a template

Edit a page or post in the WordPress editor.
In the Page Attributes (or Post Attributes) panel, open the Template dropdown.
Select Full Width, no sidebar and update/publish.

Use featured images with sufficient width (e.g., 1066px+) for best presentation in full-width layouts.

Customizer Theme Options

To see available WordPress Customizer theme options:

Go to your WordPress Dashboard.
Navigate to Appearance → Customize.
Click on Theme Options.

Inside the Theme Options panel you will also find helper sections: Getting Started (Documentation and Contact Us buttons), Recommended Plugins, and Upgrade to Pro.

Site Identity

Below is the complete list of Site Identity options available:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
custom_logo	Logo	Image ID of the custom logo uploaded through the Customizer. Recommended size: 315 × 80 pixels (flexible width and height).	Media Uploader	Integer (attachment ID)	0 (none)
blogname	Site Title	Main title of the website shown in the header, browser-tabs, and search-results.	Text	A string	"My WordPress Site" (installer-set)
blogdescription	Tagline	Short descriptive sentence (appears next to or below the title when supported by the theme).	Text	A string	"Just another WordPress site"
display_header_text	Display Site Title & Tagline	Toggles whether the title/tagline are printed on the front-end. When off they remain in the markup for accessibility but are hidden with CSS.	Toggle Switch	true / false	true
site_icon	Site Icon (Favicon)	Image ID for the favicon/app-icon (512 × 512 px recommended). Used in browser tabs, bookmark tiles and WP mobile app.	Media Uploader	Integer (attachment ID)	0 (none)

Colors

Below is the complete list of Colors options available:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
background_color	Background Color	Pick the site Background Color. To change Background Color, need to remove background image first.	Color Picker	Hex color code (e.g. #ffffff)	#e4e0db
header_textcolor	Header Text Color	Pick the Header Text Color for the site title and tagline.	Color Picker	Hex color code (e.g. #ffffff)	#333333

Header Image

Below is the complete list of Header Image options available:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
header_image	Header Image	Upload or select a header image. Suggested width is 1086 pixels.	Media Uploader	Image URL	(none)

Background Image

Below is the complete list of Background Image options available:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
background_image	Background Image	Upload or select a background image for the site.	Media Uploader	Image URL	assets/images/background.png
background_preset	Preset	Choose a preset for how the background image is displayed.	Dropdown	Default / Fill Screen / Fit to Screen / Repeat / Custom	Default
background_position_x	Image Position (Horizontal)	Horizontal position of the background image.	Radio	Left / Center / Right	Left
background_position_y	Image Position (Vertical)	Vertical position of the background image.	Radio	Top / Center / Bottom	Top
background_size	Image Size	How the background image is sized.	Dropdown	Auto / Contain / Cover	Auto
background_repeat	Repeat Background Image	Whether the background image repeats.	Checkbox	Repeat / No Repeat	Repeat
background_attachment	Scroll with Page	Whether the background image scrolls with the page or is fixed.	Checkbox	Scroll / Fixed	Fixed

Header Options

Below is the complete list of Header Options available:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
hide_header_content	Hide Header Content	Hide the header content area entirely (logo/site title, tagline, and header banner widget).	Checkbox	true / false	false

Post Options

Below is the complete list of Post Options available:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
posts_heading	HomePage Posts Heading	Custom heading text for the homepage posts area.	Text	A string	Recent Posts
thumbnail_link	Thumbnail Link	Whether the single post featured image should link to its post.	Dropdown	Yes No	Yes
post_style	Non-Singular Posts Style	Select the post style you want for home/categories/tags/archive/search-results pages.	Dropdown	List Full	List
read_more_length	Auto Post Summary Length	Enter the number of words need to display in the post summary. Default is 25 words.	Text	A positive integer	25
read_more_text	Read More Text	Custom text for the Read More link/button in post summaries.	Text	A string	Continue Reading...
hide_posted_date	Hide Posted Date	Hide the posted date from posts.	Checkbox	true / false	false
hide_post_author	Hide Post Author	Hide the author name from posts.	Checkbox	true / false	false
hide_post_categories	Hide Post Categories	Hide post categories from posts.	Checkbox	true / false	false
hide_post_tags	Hide Post Tags	Hide tags from full posts.	Checkbox	true / false	false
hide_comments_link	Hide Comment Link	Hide the comment link on posts.	Checkbox	true / false	false
hide_post_edit	Hide Post Edit Link	Hide the edit link on full posts (for logged-in users with permission).	Checkbox	true / false	false
hide_thumbnail	Hide Thumbnails from Every Page	Hide featured images from post listings and single posts/pages everywhere.	Checkbox	true / false	false
hide_thumbnail_single	Hide Thumbnails from Posts/Pages	Hide featured images on single posts and pages. This option has no effect if you have checked "Hide Thumbnails from Every Page".	Checkbox	true / false	false
hide_post_snippet	Hide Post Snippet	Hide post snippets/excerpts from post listings.	Checkbox	true / false	false
hide_read_more_button	Hide Read More Button	Hide the Read More button from post listings.	Checkbox	true / false	false
hide_author_bio_box	Hide Author Bio Box	Hide the author biography box on single posts.	Checkbox	true / false	false

Social Links

Below is the complete list of Social Links options available. The theme supports 30 social profile links displayed in the header area, and you can also show them in the footer area.

Option ID	Option Name	Description	Control Type	Accepted Value	Default
hide_header_social_buttons	Hide Header Social Buttons	If checked, all social buttons will be hidden from the header area.	Checkbox	true / false	false
show_footer_social_buttons	Show Footer Social Buttons	If checked, all social buttons will be displayed in the footer area.	Checkbox	true / false	false
twitterlink	Twitter URL	Twitter profile URL.	Text	A valid URL	(empty)
facebooklink	Facebook URL	Facebook profile URL.	Text	A valid URL	(empty)
googlelink	Google Plus URL	Google Plus profile URL.	Text	A valid URL	(empty)
pinterestlink	Pinterest URL	Pinterest profile URL.	Text	A valid URL	(empty)
linkedinlink	Linkedin Link	LinkedIn profile URL.	Text	A valid URL	(empty)
instagramlink	Instagram Link	Instagram profile URL.	Text	A valid URL	(empty)
vklink	VK Link	VK profile URL.	Text	A valid URL	(empty)
flickrlink	Flickr Link	Flickr profile URL.	Text	A valid URL	(empty)
youtubelink	Youtube URL	YouTube channel URL.	Text	A valid URL	(empty)
vimeolink	Vimeo URL	Vimeo profile URL.	Text	A valid URL	(empty)
soundcloudlink	Soundcloud URL	SoundCloud profile URL.	Text	A valid URL	(empty)
lastfmlink	Lastfm URL	Last.fm profile URL.	Text	A valid URL	(empty)
githublink	Github URL	GitHub profile URL.	Text	A valid URL	(empty)
bitbucketlink	Bitbucket URL	Bitbucket profile URL.	Text	A valid URL	(empty)
tumblrlink	Tumblr URL	Tumblr blog URL.	Text	A valid URL	(empty)
digglink	Digg URL	Digg profile URL.	Text	A valid URL	(empty)
deliciouslink	Delicious URL	Delicious profile URL.	Text	A valid URL	(empty)
stumblelink	Stumbleupon Link	StumbleUpon profile URL.	Text	A valid URL	(empty)
redditlink	Reddit Link	Reddit profile URL.	Text	A valid URL	(empty)
dribbblelink	Dribbble Link	Dribbble profile URL.	Text	A valid URL	(empty)
behancelink	Behance Link	Behance portfolio URL.	Text	A valid URL	(empty)
codepenlink	Codepen Link	CodePen profile URL.	Text	A valid URL	(empty)
jsfiddlelink	JSFiddle Link	JSFiddle profile URL.	Text	A valid URL	(empty)
stackoverflowlink	Stack Overflow Link	Stack Overflow profile URL.	Text	A valid URL	(empty)
stackexchangelink	Stack Exchange Link	Stack Exchange profile URL.	Text	A valid URL	(empty)
bsalink	BuySellAds Link	BuySellAds profile URL.	Text	A valid URL	(empty)
slidesharelink	SlideShare Link	SlideShare profile URL.	Text	A valid URL	(empty)
skypeusername	Skype Username	Skype username (not URL).	Text	A plain text username	(empty)
emailaddress	Email Address	Email address for contact.	Text	A valid email address	(empty)
rsslink	RSS Feed URL	RSS feed URL.	Text	A valid URL	(empty)

Footer

Below is the complete list of Footer options available:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
footer_text	Footer copyright notice	Custom copyright notice text displayed in the footer. If left empty, the theme shows "Copyright © [Year] [Site Name]" plus a "Design by ThemesDNA.com" credit link.	Text	A string (HTML allowed)	(empty)
hide_footer_widgets	Hide Footer Widgets	Hide all footer widget areas.	Checkbox	true / false	false

Other Options

Below is the complete list of Other Options available:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
enable_widgets_block_editor	Enable Gutenberg Widget Block Editor	Enable the Gutenberg block-based widget editor instead of the classic widget editor.	Checkbox	true / false	false

Translation

NeatMag is fully translation-ready. All theme strings are wrapped in translation functions, and a translation template file is included with the theme.

🌐 Translating the Theme

The theme includes a neatmag.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:

neatmag-[language_code].po
neatmag-[language_code].mo

Place them inside the /languages folder in the theme.

↔️ RTL (Right-to-Left) Languages

The free version of NeatMag does not include an RTL stylesheet. If you run a Right-to-Left language site (e.g., Arabic, Hebrew, or Persian), you can add RTL styles yourself via a child theme, custom CSS, or an RTL plugin.

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.

Performance & SEO Tips

Here are some best practices to improve your site's performance and SEO when using NeatMag:

Use a caching plugin — Install W3 Total Cache, WP Super Cache, or LiteSpeed Cache to improve page load times.
Optimize images — Use plugins like Imagify or EWWW Image Optimizer to compress images.
Use a CDN — A Content Delivery Network (e.g., Cloudflare) serves your content from servers closest to your visitors.
Install an SEO plugin — Use Yoast SEO or Rank Math to manage meta tags, sitemaps, and structured data.
Keep WordPress updated — Always use the latest versions of WordPress, themes, and plugins.
Minimize plugins — Only keep the plugins you actually use.
Use quality hosting — A good hosting provider makes a significant difference in performance.
Set featured images — Always set a featured image for posts to ensure proper display in post listings and when sharing on social media.

FAQ

In this section, you'll find quick answers to the most frequently asked questions about using the NeatMag theme. If you can't find your answer here, you can contact our support team for more help.

My menus disappeared after theme activation. What should I do?

Go to Appearance → Menus → Manage Locations and reassign your existing menus to the correct theme locations.

How do I change the style of posts on my homepage?

Go to Appearance → Customize → Theme Options → Post Options and choose a Non-Singular Posts Style of either List or Full. This controls how posts are displayed on home, categories, tags, archive, and search results pages.

How do I add social media links?

Go to Appearance → Customize → Theme Options → Social Links and enter your profile URLs for each social network. The social icons appear in the header area, and you can also display them in the footer area by enabling Show Footer Social Buttons.

How do I change the footer copyright text?

Go to Appearance → Customize → Theme Options → Footer and enter your custom text in the Footer copyright notice field.

How do I use a static page as my homepage?

Create at least two pages (one for the homepage, one for the blog).
Go to Settings → Reading.
Select A static page under "Your homepage displays".
Choose your homepage and posts page from the dropdowns.
Click Save Changes.

How do I enable sticky sidebars?

The NeatMag theme has sticky sidebars enabled by default using the Theia Sticky Sidebar library; they become active on screens wider than 785px. The sticky menu works automatically on screens wider than 1112px. No additional configuration is needed.

How do I get numbered post navigation instead of Older/Newer posts links?

NeatMag includes built-in support for the WP-PageNavi plugin. Install and activate it, and numbered pagination will automatically replace the default post navigation links.

Troubleshooting

This section covers common technical problems you may encounter. If your issue isn't listed, reach out to our support team.

Post thumbnails are missing when sharing on social media

Install an SEO plugin like Yoast SEO or Rank Math and enable Open Graph tags. Always set a featured image for each post.

I get "The uploaded file exceeds the upload_max_filesize directive" error

Increase the upload limit via php.ini, .htaccess, or contact your hosting provider. Alternatively, use FTP.

Images look blurry or have the wrong sizes

Run Regenerate Thumbnails from Tools → Regenerate Thumbnails to ensure all images match the theme's expected sizes. Make sure posts have featured images set.

Widgets are not appearing

Go to Appearance → Widgets and make sure widgets are added to the correct widget areas. Consider disabling "Enable Gutenberg Widget Block Editor" in Theme Options → Other Options.

Support & Licensing

The NeatMag 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 NeatMag PRO

For more features including color options, font options, related posts, custom widgets, page templates, and much more, consider upgrading to NeatMag PRO.

Changelog & Versioning

The following is a log of all updates and changes made to NeatMag. We recommend always using the latest version.

= Version 1.0.5 =

Fixed coding issues.

= Version 1.0.4 =

Fixed coding issues.
Theme Customizer updated.
Many improvements.

= Version 1.0.3 =

Fixed coding issues.

= Version 1.0.2 =

Fixed coding issues.
Theme customizer updated.

= Version 1.0.1 =

Fixed coding issues.
Improved coding.
Improved accessibility.

= Version 1.0.0 =

Initial Release.

Date Formats

You can use the following date format values to control how dates appear in various places such as post metadata 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.

Format Key	Example Output
H:i	00:50
g:i a	12:50 am
g:i A	12:50 AM
g:i:s a	12:50:48 am
g:i:s A	12:50:48 AM
d.m.y	27.11.10
Y.m.d	2010.11.27
Y-m-d	2010-11-27
Y/m/d	2010/11/27
m.d.Y	11.27.2010
m-d-Y	11-27-2010
m/d/Y	11/27/2010
d.m.Y	27.11.2010
d-m-Y	27-11-2010
d/m/Y	27/11/2010
m/d/Y g:i:s a	11/27/2010 12:50:48 am
m/d/Y g:i:s A	11/27/2010 12:50:48 AM
Y/m/d \a\t g:i a	2010/11/27 at 12:50 am
Y/m/d \a\t g:i A	2010/11/27 at 12:50 AM
d F	27 November
F, Y	November, 2010
F j, Y	November 27, 2010
d M Y	27 Nov 2010
M j, Y	Nov 27, 2010
M j, Y @ H:i	Nov 27, 2010 @ 0:50
l, F j, Y	Saturday, November 27, 2010
l, F jS, Y	Saturday, November 27th, 2010

Introduction

Quick Start Guide

Theme Features

Theme Installation

Method 1: Install via WordPress Dashboard (Recommended)

Method 2: Upload via WordPress Dashboard

Method 3: Upload via FTP/File Manager

Troubleshooting Installation Issues

Import Demo Content

Manual Demo Import

Step 1: Import Main Site Content

Step 2: Import Widgets

Step 3: Import Customizer Settings

Regenerate Thumbnails

Header Image

How to add a header image

Navigation Menus

Widget Areas

Header Banner

Main Sidebar

Top Full Width Widgets (Home Page Only)

Top Full Width Widgets (Every Page)

Top Widgets (Home Page Only)

Top Widgets (Every Page)

Bottom Widgets (Home Page Only)

Bottom Widgets (Every Page)

Footer 1

Footer 2

Footer 3

Footer 4

Page Templates

How to apply a template

Customizer Theme Options

Site Identity

Colors

Header Image

Background Image

Header Options

Post Options

Social Links

Footer

Other Options

Translation

🌐 Translating the Theme

↔️ RTL (Right-to-Left) Languages

Performance & SEO Tips

FAQ

My menus disappeared after theme activation. What should I do?

How do I change the style of posts on my homepage?

How do I add social media links?

How do I change the footer copyright text?

How do I use a static page as my homepage?

How do I enable sticky sidebars?

How do I get numbered post navigation instead of Older/Newer posts links?

Troubleshooting

Post thumbnails are missing when sharing on social media

I get "The uploaded file exceeds the upload_max_filesize directive" error

Images look blurry or have the wrong sizes

Widgets are not appearing

Support & Licensing

What's included in free support:

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

Upgrade to NeatMag PRO

Changelog & Versioning

= Version 1.0.5 =

= Version 1.0.4 =

= Version 1.0.3 =

= Version 1.0.2 =

= Version 1.0.1 =

= Version 1.0.0 =

Date Formats