NeatMag PRO Documentation

Introduction

Thank you for choosing NeatMag PRO WordPress Theme—an elegant, flexible, and fully responsive 2-column magazine and blogging theme crafted by ThemesDNA. It’s ideal for professional magazine-style sites, blogs, and content-rich portals, and this guide walks you through setup and customization step by step.

Highlights include a fully responsive layout with multiple post styles, 19 widget areas, 15 custom widgets (Featured Posts 1–9), 8 page templates, rich Customizer controls, built-in social icons/share buttons, sticky menu and sidebar, related posts, author bio box, built-in contact form, translation readiness, Schema.org SEO markup, 100+ Google Fonts, a back-to-top button, footer copyright text controls, and an option to remove theme designer credits. If you need help beyond these docs, please contact our support team.

Cuurent Theme Version: 1.0.5

Theme Installation

After purchasing the NeatMag PRO WordPress Theme, you'll receive a download link via email. Check your email inbox (or spam folder) for the product delivery email. Click the provided download link to download the theme's .zip file to your computer. Follow one of a method given below to install the theme on your website.

Upgrading from the Free NeatMag Theme?

NeatMag PRO is a separate theme. Whether or not you're currently using the free NeatMag theme, you need to install NeatMag PRO using one of the methods below.

If you're upgrading from the free version, most of your existing WordPress Customizer settings will remain in place. So you don't need to reconfigure everything from scratch. However, you will need to reupload a few images and reapply specific color settings.

After activating NeatMag PRO, go to Appearance → Customize and reupload the following:

  • Site Logo
  • Site Icon (favicon)
  • Header Image
  • Background Image

If you changed below color options in the free version, reapply them in Appearance → Customize → Theme Options → Colors:

  • Header Text Color
  • Background Color

Tip: You can install PRO without deleting the free theme. Use Live Preview to confirm your layout, then click Activate & Publish.

Method 1: Install Using the WordPress Dashboard (Easiest and Fastest)

This is the easiest and fastest method to install this WordPress theme.

  1. Go to "WordPress Dashboard" → "Appearance" → "Themes" and click on "Add New" button.
  2. Click on "Upload Theme" button and choose the zip file you have downloaded.
  3. Click on "Install Now" button.
  4. Activate the theme.
  5. Now go to "Appearance" → "Customize" to configure theme options.

Method 2: Install using cPanel File Manager

In some cases, you may not be able to install a WordPress theme through the WordPress dashboard—especially if the theme's ZIP file exceeds the maximum upload size limit. When this happens, you can install the theme using cPanel's File Manager, which is often simpler than using FTP. Follow the steps below to install your theme via the File Manager in cPanel.

  1. Log in to your cPanel account. Your cPanel URL will be https://yourdomain.com/cpanel or a similar URL.
  2. Click on the "File Manager" icon. It's usually under the "Files" section.
  3. You are now in the "File Manager". Open the public_html folder, which is your website's root directory.
  4. Locate the wp-content folder inside "public_html," then open the themes folder inside of it.
  5. In the File Manager interface, click the "Upload" button and choose the theme's .zip file from your local drive.
  6. After it has been uploaded, right-click the .zip file and choose "Extract" or "Unzip".
  7. You can now delete the uploaded .zip file, but it's optional.
  8. Log in to your WordPress dashboard through your web browser.
  9. Go to Appearance → Themes. Now you will see the newly extracted theme.
  10. Make it your active theme by clicking the "Activate" button next to it.

Note: If your hosting provider doesn't offer cPanel, look for a File Manager option in your hosting dashboard (like DirectAdmin, Plesk, or CyberPanel). The process is usually very similar—just find the wp-content/themes folder and upload/extract the theme ZIP file there.

Method 3: Install using FTP

Installing a WordPress theme via FTP is straightforward, though it involves a few more steps compared to using the built-in theme uploader. Here's how to install a WordPress theme using FTP:

  1. Unzip the theme's .zip file you have downloaded.
  2. Connect to your hosting account using an FTP client such as "FileZilla" or "Core FTP".
  3. Navigate to the /wp-content/themes folder in the "Remote site" section.
  4. In the "Local site" section, locate the unzipped theme folder.
  5. Drag and drop the unzipped theme folder from the "Local site" section to the "Remote site" section.
  6. Be patient and let the transfer finish.
  7. Once the transfer is complete, log in to your WordPress dashboard and navigate to Appearance > Themes.
  8. Find the theme you just uploaded and click Activate.

Troubleshooting Tips

  • Didn't receive the download email? Wait 5–10 minutes or check your spam/junk folder. But if you still can not find this email or download link is broken, please inform us. we will send it ASAP.
  • "The uploaded file exceeds the upload_max_filesize directive in php.ini." - If you get this error when following the "Method 1", follow this tutorial: https://themesdna.com/blog/increase-maximum-file-upload-size-wordpress/
  • My menus disappeared or look different. Go to Appearance → Menus → Manage Locations and reassign your menus to the correct locations.
  • My header text or background color looks different after activating PRO. Reapply your colors in Appearance → Customize → Theme Options → Colors for Header Text Color and Background Color. Then publish.
  • Still can't install the theme? Contact us for help.

Import Demo Content

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

Manual Demo Import

Step 1: Import Main Site Content

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

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

Step 2: Import Widgets

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

Step 3: Import Customizer Settings

  1. Download: Customizer File
  2. Install the Customizer Export/Import plugin.
  3. Go to Appearance → Customize → Export/Import.
  4. 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 PRO 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 NeatMag PRO theme.

Header Image

NeatMag PRO supports a full-width header image that appears at the top of your site, above the logo and navigation area.

How to Add a Header Image?

  1. Go to AppearanceCustomizeHeader Image.
  2. Click Add new image.
  3. Select or upload an image from the Media Library.
  4. Crop the image if prompted.
  5. Click Publish to save.

The header image will display above the site logo and header banner area. It is wrapped in a link that points to your site's home page.

Custom Widgets

NeatMag PRO comes with several powerful custom widgets that help you display posts and other content in a variety of ways. You can add these widgets to any widget area via AppearanceWidgets.

NeatMag Recent Posts Widget

Displays your most recent posts with thumbnails and post metadata.

Option ID Option Name Description Control Type Accepted Value Default
titleTitleHeading displayed above the widget.TextAny text"Recent Posts"
numberNumber of posts to showTotal posts to list.Text (integer)Positive integer5
show_thumbnailDisplay Post Thumbnail?Show featured image for each post.Checkboxtrue / falsetrue
show_dateDisplay Post Date?Show published date.Checkboxtrue / falsetrue
show_commentsDisplay Number of Comments?Show comment count.Checkboxtrue / falsetrue
show_snippetDisplay Post Snippet?Show 20-word excerpt.Checkboxtrue / falsetrue

NeatMag Random Posts Widget

Displays random posts with thumbnails and metadata.

Option ID Option Name Description Control Type Accepted Value Default
titleTitleHeading displayed above the widget.TextAny text"Random Posts"
numberNumber of posts to showTotal posts to list (random order).Text (integer)Positive integer5
show_thumbnailDisplay Post Thumbnail?Show featured image for each post.Checkboxtrue / falsetrue
show_dateDisplay Post Date?Show published date.Checkboxtrue / falsetrue
show_commentsDisplay Number of Comments?Show comment count.Checkboxtrue / falsetrue
show_snippetDisplay Post Snippet?Show 20-word excerpt.Checkboxtrue / falsetrue

NeatMag Tabbed Widget

A multi-tab widget that displays Recent, Popular, and Random posts in a tabbed interface. Great for sidebars to maximize content exposure in limited space.

Option ID Option Name Description Control Type Accepted Value Default
titleTitleHeading displayed above the widget.TextAny text"Tabbed Widget"
show_popular_postsDisplay Tab 1 (Popular Posts)Enable popular posts tab.Checkboxtrue / falsetrue
show_recent_postsDisplay Tab 2 (Recent Posts)Enable recent posts tab.Checkboxtrue / falsetrue
show_random_postsDisplay Tab 3 (Random Posts)Enable random posts tab.Checkboxtrue / falsetrue
tab_one_nameTab 1 NameLabel for popular tab.TextAny text"Popular"
tab_two_nameTab 2 NameLabel for recent tab.TextAny text"Recent"
tab_three_nameTab 3 NameLabel for random tab.TextAny text"Random"
numberNumber of posts to showPosts per tab.Text (integer)Positive integer3
snippet_lengthPost snippet lengthExcerpt length in words.Text (integer)Positive integer20
show_thumbnailDisplay Post Thumbnail?Show featured image for each post.Checkboxtrue / falsetrue
show_dateDisplay Post Date?Show published date.Checkboxtrue / falsetrue
show_commentsDisplay Number of Comments?Show comment count.Checkboxtrue / falsetrue
show_snippetDisplay Post Snippet?Show excerpt using snippet_length.Checkboxtrue / falsetrue

NeatMag About Me Widget

Displays an "About Me" section with a custom image, text, and description. Ideal for sidebars or footer areas.

Option ID Option Name Description Control Type Accepted Value Default
titleTitleHeading displayed above the widget.TextAny text"About Me"
imageProfile Image URLImage displayed above the bio.Text (URL)Valid image URLBlank
descriptionDescriptionBio/about text.TextareaAny text/HTMLBlank
round_buttonsDisplay round social buttons?Toggle icon style.Checkboxtrue / falsefalse
facebookFacebook URLLink for Facebook icon.Text (URL)Valid URLBlank
twitterTwitter URLLink for Twitter icon.Text (URL)Valid URLBlank
googleplusGoogle Plus URLLink for Google Plus icon.Text (URL)Valid URLBlank
pinterestPinterest URLLink for Pinterest icon.Text (URL)Valid URLBlank
linkedinLinkedIn URLLink for LinkedIn icon.Text (URL)Valid URLBlank
instagramInstagram URLLink for Instagram icon.Text (URL)Valid URLBlank
flickrFlickr URLLink for Flickr icon.Text (URL)Valid URLBlank
youtubeYoutube URLLink for Youtube icon.Text (URL)Valid URLBlank
vimeoVimeo URLLink for Vimeo icon.Text (URL)Valid URLBlank
soundcloudSoundCloud URLLink for SoundCloud icon.Text (URL)Valid URLBlank
lastfmLastfm URLLink for Lastfm icon.Text (URL)Valid URLBlank
githubGithub URLLink for Github icon.Text (URL)Valid URLBlank
bitbucketBitbucket URLLink for Bitbucket icon.Text (URL)Valid URLBlank
tumblrTumblr URLLink for Tumblr icon.Text (URL)Valid URLBlank
diggDigg URLLink for Digg icon.Text (URL)Valid URLBlank
deliciousDelicious URLLink for Delicious icon.Text (URL)Valid URLBlank
stumbleuponStumbleupon URLLink for Stumbleupon icon.Text (URL)Valid URLBlank
redditReddit URLLink for Reddit icon.Text (URL)Valid URLBlank
dribbbleDribbble URLLink for Dribbble icon.Text (URL)Valid URLBlank
behanceBehance URLLink for Behance icon.Text (URL)Valid URLBlank
vkVK URLLink for VK icon.Text (URL)Valid URLBlank
codepenCodepen URLLink for Codepen icon.Text (URL)Valid URLBlank
jsfiddleJSFiddle URLLink for JSFiddle icon.Text (URL)Valid URLBlank
stackoverflowStack Overflow URLLink for Stack Overflow icon.Text (URL)Valid URLBlank
stackexchangeStack Exchange URLLink for Stack Exchange icon.Text (URL)Valid URLBlank
buyselladsBuySellAds URLLink for BuySellAds icon.Text (URL)Valid URLBlank
slideshareSlideShare URLLink for SlideShare icon.Text (URL)Valid URLBlank
skypeSkype UsernameUsername used for Skype link.TextSkype usernameBlank
envelopeEmail AddressEmail used for mailto link.EmailValid email addressBlank
rssRSS Feed URLLink for RSS icon.Text (URL)Valid URLBlank

NeatMag Social Widget

Displays social media profile links with icons. Configure your social profile URLs in AppearanceCustomizeTheme OptionsSocial Links.

Option ID Option Name Description Control Type Accepted Value Default
titleTitleHeading displayed above the widget.TextAny text"Social Buttons"
round_buttonsDisplay round buttons?Toggle icon style.Checkboxtrue / falsefalse
facebookFacebookLink for Facebook icon.Text (URL)Valid URLBlank
twitterTwitterLink for Twitter icon.Text (URL)Valid URLBlank
googleplusGoogle PlusLink for Google Plus icon.Text (URL)Valid URLBlank
pinterestPinterestLink for Pinterest icon.Text (URL)Valid URLBlank
linkedinLinkedinLink for LinkedIn icon.Text (URL)Valid URLBlank
instagramInstagramLink for Instagram icon.Text (URL)Valid URLBlank
flickrFlickrLink for Flickr icon.Text (URL)Valid URLBlank
youtubeYoutubeLink for Youtube icon.Text (URL)Valid URLBlank
vimeoVimeoLink for Vimeo icon.Text (URL)Valid URLBlank
soundcloudSoundCloudLink for SoundCloud icon.Text (URL)Valid URLBlank
lastfmLastfmLink for Lastfm icon.Text (URL)Valid URLBlank
githubGithubLink for Github icon.Text (URL)Valid URLBlank
bitbucketBitbucketLink for Bitbucket icon.Text (URL)Valid URLBlank
tumblrTumblrLink for Tumblr icon.Text (URL)Valid URLBlank
diggDiggLink for Digg icon.Text (URL)Valid URLBlank
deliciousDeliciousLink for Delicious icon.Text (URL)Valid URLBlank
stumbleuponStumbleuponLink for Stumbleupon icon.Text (URL)Valid URLBlank
redditRedditLink for Reddit icon.Text (URL)Valid URLBlank
dribbbleDribbbleLink for Dribbble icon.Text (URL)Valid URLBlank
behanceBehanceLink for Behance icon.Text (URL)Valid URLBlank
vkVKLink for VK icon.Text (URL)Valid URLBlank
codepenCodepenLink for Codepen icon.Text (URL)Valid URLBlank
jsfiddleJSFiddleLink for JSFiddle icon.Text (URL)Valid URLBlank
stackoverflowStack OverflowLink for Stack Overflow icon.Text (URL)Valid URLBlank
stackexchangeStack ExchangeLink for Stack Exchange icon.Text (URL)Valid URLBlank
buyselladsBuySellAdsLink for BuySellAds icon.Text (URL)Valid URLBlank
slideshareSlideShareLink for SlideShare icon.Text (URL)Valid URLBlank
skypeSkypeUsername for Skype link.TextSkype usernameBlank
envelopeEmail AddressEmail used for mailto link.EmailValid email addressBlank
rssRSS FeedLink for RSS icon.Text (URL)Valid URLBlank

Widget Areas

NeatMag PRO provides 19 widget areas that give you full control over where content is displayed. You can manage all widget areas via AppearanceWidgets.

#Widget AreaLocation / Description
1Header BannerLocated in the header area, next to the logo. Use it for ads or a banner. Hidden when "Full Width Header" is enabled.
2Main SidebarThe primary sidebar displayed alongside your main content area.
3Top Full Width Widgets (Home Page Only)Full-width area above the main content, visible only on the home page. Ideal for Featured Posts widgets.
4Top Full Width Widgets (Posts Only)Full-width area above content, visible only on single post pages.
5Top Full Width Widgets (Posts/Pages Only)Full-width area above content, visible on both single posts and pages.
6Top Full Width Widgets (Every Page)Full-width area above content, visible on every page of the site.
7Top Widgets (Home Page Only)Displayed above the main content column, visible only on the home page.
8Top Widgets (Posts Only)Displayed above the main content column, visible only on single post pages.
9Top Widgets (Posts/Pages Only)Displayed above the main content column, visible on both single posts and pages.
10Top Widgets (Every Page)Displayed above the main content column, visible on every page.
11Bottom Widgets (Home Page Only)Displayed below the main content column, visible only on the home page.
12Bottom Widgets (Posts Only)Displayed below the main content column, visible only on single post pages.
13Bottom Widgets (Posts/Pages Only)Displayed below the main content column, visible on both single posts and pages.
14Bottom Widgets (Every Page)Displayed below the main content column, visible on every page.
15Post Bottom WidgetsDisplayed below the post content on single post pages, before comments.
16Footer 1First column in the footer widget area.
17Footer 2Second column in the footer widget area.
18Footer 3Third column in the footer widget area.
19Footer 4Fourth column in the footer widget area.

How to Control Widget Visibility by Location

In addition to the location-specific widget areas above, you can use third-party plugins to control individual widget visibility:

  • Widget Display Conditions — A lightweight plugin to show/hide widgets on specific pages, posts, categories, etc.
  • Widget Context — Another plugin for controlling widget visibility by context.

These plugins let you show or hide any widget on specific pages, posts, categories, archives, search results, and more.

Custom Page Templates

NeatMag PRO includes 8 custom page/post templates to help you create pages and posts with different layouts:

  • Contact Page Template — A page template with a built-in contact form.
  • Sitemap Template — Displays an organized sitemap of your site's pages, categories, and archives.
  • Full Width Page (No Sidebar) — A page template without any sidebar.
  • Full Width Page with Sidebar Below — A full-width page with the sidebar displayed below the content.
  • Left Sidebar Page — A page template with the sidebar on the left side.
  • Full Width Post (No Sidebar) — A single post template without any sidebar.
  • Full Width Post with Sidebar Below — A full-width post with the sidebar displayed below the content.
  • Left Sidebar Post — A single post template with the sidebar on the left side.

How to Use a Page Template

  1. Go to PagesAdd New (or edit an existing page).
  2. In the page editor, look for the Page Attributes section (or Template dropdown in the block editor sidebar).
  3. Select the desired template from the Template dropdown.
  4. Add your content and click Publish or Update.

How to Create a Contact Page

  1. Go to PagesAdd New.
  2. Enter a title (e.g., "Contact Us").
  3. Select Contact Page from the Template dropdown.
  4. Add any introductory text in the editor (optional).
  5. Click Publish.
  6. Go to AppearanceCustomizeTheme OptionsOther Options and enter your Contact Form Email Address. This is where contact form submissions will be sent.

How to Create a Sitemap Page

  1. Go to PagesAdd New.
  2. Enter a title (e.g., "Sitemap").
  3. Select Sitemap from the Template dropdown.
  4. Click Publish.

The sitemap page will automatically generate a listing of your site's pages, categories, and monthly archives.

Customizer Theme Options

NeatMag PRO provides extensive customization options through the WordPress Customizer. Go to AppearanceCustomize to access all theme options. The options are organized under the Theme Options panel.

Site Identity Options

Found under AppearanceCustomizeTheme OptionsSite Identity.

Option ID Option Name Description Control Type Accepted Value Default
custom_logoLogoUpload a custom logo image for your site header.Image UploadImage file (recommended high resolution)None (uses Site Title/Tagline)
blognameSite TitleYour site's name, displayed in the header when no logo is set.TextAny textCurrent WordPress Site Title
blogdescriptionTaglineA brief description of your site, displayed below the site title.TextAny textCurrent WordPress Tagline (default "Just another WordPress site")
display_header_textDisplay Site Title and TaglineShow or hide the site title and tagline in the header.Checkboxtrue / falsetrue
site_iconSite IconUpload a site icon (favicon) shown in browser tabs and apps.Image UploadSquare image, at least 512×512 pixelsNone

Colors Options

Found under AppearanceCustomizeTheme OptionsColors. These options let you customize the colors of virtually every element in the theme.

Option ID Option Name Description Control Type Accepted Value Default
body_text_colorMain Text ColorPrimary body text color.Color PickerHex color#555555
link_colorMain Link ColorDefault link color.Color PickerHex color#666666
link_hover_colorMain Link Hover ColorHover state for links.Color PickerHex color#000000
headings_colorGeneral Headings ColorColor for headings (H1–H6).Color PickerHex color#111111
outer_border_one_colorOuter Border 1 ColorLight outer border color.Color PickerHex color#f9f9f9
outer_border_two_colorOuter Border 2 ColorSecondary outer border color.Color PickerHex color#a8a8a8
header_bg_colorHeader Background ColorBackground for the header area.Color PickerHex color#ffffff
menu_bg_colorMenu Background ColorMain navigation background.Color PickerHex color#333333
menu_bd_colorMenu Border ColorBorder around menu.Color PickerHex color#555555
menu_colorMenu Link ColorDefault menu link text.Color PickerHex color#ffffff
menu_hover_colorMenu Link Hover ColorHover text color for menu links.Color PickerHex color#ffc845
menu_hover_bg_colorMenu Link Hover Background ColorHover background for menu links.Color PickerHex color#000000
submenu_one_bg_colorSub Menu Background ColorDropdown submenu background.Color PickerHex color#444444
submenu_one_bd_colorSub Menu Border ColorBorder for dropdown menus.Color PickerHex color#666666
menu_icon_colorResponsive Menu Icon ColorColor of the mobile menu icon.Color PickerHex color#ffffff
header_social_colorHeader Social Icons ColorDefault header social icon color.Color PickerHex color#ffffff
header_social_hover_colorHeader Social Icons Hover ColorHover color for header social icons.Color PickerHex color#dddddd
fullwidth_bg_colorTop Full Width Area Background ColorBackground for top full-width area.Color PickerHex color#ffffff
content_bg_colorMain Content Background ColorBackground of main content area.Color PickerHex color#ffffff
post_title_colorPost Title ColorDefault post title color.Color PickerHex color#000000
post_title_hover_colorPost Title Hover ColorHover color for post titles.Color PickerHex color#333333
g2s2_title_colorGrid 2/Standard 2/Slide Post Title ColorTitle color for grid/standard 2/slide layouts.Color PickerHex color#ffffff
g2s2_title_hover_colorGrid 2/Standard 2/Slide Post Title Hover ColorHover title color for grid/standard 2/slide layouts.Color PickerHex color#ffffff
post_body_link_colorPost Content Link ColorLinks inside post content.Color PickerHex color#409BD4
post_body_link_hover_colorPost Content Link Hover ColorHover color for post content links.Color PickerHex color#08ACD5
postcats_colorPost Categories ColorCategory label text color.Color PickerHex color#ffffff
postcats_bg_colorPost Categories Background ColorBackground for category labels.Color PickerHex color#ab8959
postcats_hover_colorPost Categories Hover ColorHover text color for category labels.Color PickerHex color#ffffff
postcats_bg_hover_colorPost Categories Hover Background ColorHover background for category labels.Color PickerHex color#000000
post_meta_colorPost Meta ColorMeta text (date, author, etc.).Color PickerHex color#666666
post_meta_hover_colorPost Meta Hover ColorHover color for post meta.Color PickerHex color#000000
g2s2_meta_colorGrid 2/Standard 2 Post Meta ColorMeta text color for grid/standard 2.Color PickerHex color#ffffff
g2s2_meta_hover_colorGrid 2/Standard 2 Post Meta Hover ColorHover meta color for grid/standard 2.Color PickerHex color#ffffff
rmore_colorRead More Button ColorText color for Read More button.Color PickerHex color#ffffff
rmore_bg_colorRead More Button Background ColorBackground color for Read More button.Color PickerHex color#333333
rmore_hover_colorRead More Button Hover ColorHover text color for Read More button.Color PickerHex color#ffffff
rmore_bg_hover_colorRead More Button Hover Background ColorHover background for Read More button.Color PickerHex color#000000
fpost_bg_colorFeatured Posts Background ColorBackground for featured post blocks.Color PickerHex color#f7f7f7
fpost_bg_hover_colorFeatured Posts Hover Background ColorHover background for featured posts.Color PickerHex color#f2f2f2
fpost_bd_one_colorFeatured Posts Border Color 1Primary border color for featured posts.Color PickerHex color#ffffff
fpost_bd_two_colorFeatured Posts Border Color 2Secondary border color for featured posts.Color PickerHex color#eaeaea
fpost_bd_three_colorFeatured Posts Border Color 3Third border color for featured posts.Color PickerHex color#ececec
sidebar_title_colorSidebar Title ColorText color for sidebar titles.Color PickerHex color#ffffff
sidebar_title_bg_one_colorSidebar Title Background Color 1First gradient/solid color for sidebar title.Color PickerHex color#000000
sidebar_title_bg_two_colorSidebar Title Background Color 2Second gradient/solid color for sidebar title.Color PickerHex color#cf8d2e
sidebar_link_colorSidebar Link ColorDefault sidebar link color.Color PickerHex color#444444
sidebar_link_hover_colorSidebar Link Hover ColorHover color for sidebar links.Color PickerHex color#666666
sidebar_list_bd_colorSidebar List Border ColorBorder color for sidebar lists.Color PickerHex color#eeeeee
tag_cloud_colorTag Cloud Link ColorText color for tag cloud links.Color PickerHex color#ffffff
tag_cloud_bg_colorTag Cloud Link BackgroundBackground for tag cloud links.Color PickerHex color#888888
tag_cloud_hover_colorTag Cloud Link Hover ColorHover text color for tag cloud.Color PickerHex color#ffffff
tag_cloud_hover_bg_colorTag Cloud Link Hover BackgroundHover background for tag cloud.Color PickerHex color#000000
social_bg_colorFooter Social Buttons Background ColorBackground for footer social icons.Color PickerHex color#000000
social_bd_colorFooter Social Buttons Border ColorBorder for footer social icons.Color PickerHex color#555555
footer_bg_colorFooter Background ColorBackground for footer area.Color PickerHex color#252525
footer_title_colorFooter Title ColorFooter widget title text color.Color PickerHex color#ffffff
footer_title_bd_colorFooter Title Border ColorBorder color under footer titles.Color PickerHex color#5A5656
footer_text_colorFooter Text ColorFooter body text.Color PickerHex color#cecece
footer_link_colorFooter Link ColorLinks in footer.Color PickerHex color#dbdbdb
footer_link_hover_colorFooter Link Hover ColorHover state for footer links.Color PickerHex color#ffffff
footer_list_bd_colorFooter List Border ColorBorder color for footer lists.Color PickerHex color#2d2d2d
cp_bg_colorCopyrights Background ColorBackground for copyrights bar.Color PickerHex color#303436
cp_bd_colorCopyrights Border ColorBorder above copyrights bar.Color PickerHex color#3D3D3D
cp_colorCopyrights Text ColorText color in copyrights bar.Color PickerHex color#ECFFF1
selected_text_colorSelected Text ColorText color when highlighted.Color PickerHex color#ffffff
selected_text_bg_colorSelected Text Background ColorBackground when text is selected.Color PickerHex color#333333
disable_shadow_colorDisable Shadow ColorDisable shadows across the theme.Checkboxtrue / falsefalse

Font Options

Found under AppearanceCustomizeTheme OptionsFont Options. You can customize the font family, size, weight, style, and line height of various elements.

Option ID Option Name Description Control Type Accepted Value Default
font_subsetsFont SubsetsSelect subsets to load (e.g., Latin, Cyrillic).Multi-selectlatin, latin-ext, cyrillic, greek, vietnameselatin
body_fontsBody Font-FamilyFont family for body text.SelectGoogle/system fontsDomine
body_font_sizeBody Font-SizeFont size for body text.Select8px–72px13px
body_font_weightBody Font-WeightWeight for body text.Select400 / 700400
body_font_styleBody Font-StyleStyle for body text.Selectnormal / italicnormal
body_line_heightBody Line-HeightLine height for body text.TextNumeric (e.g., 1.6)1.6
site_title_fontsSite Title Font-FamilyFont for site title.SelectGoogle/system fontsPlayfair Display
site_title_font_sizeSite Title Font-SizeSize for site title.Select8px–72px24px
site_title_font_weightSite Title Font-WeightWeight for site title.Select400 / 700700
site_title_font_styleSite Title Font-StyleStyle for site title.Selectnormal / italicnormal
site_title_line_heightSite Title Line-HeightLine height for site title.TextNumeric1
site_desc_fontsSite Description Font-FamilyFont for tagline/description.SelectGoogle/system fontsDomine
site_desc_font_sizeSite Description Font-SizeSize for tagline.Select8px–72px13px
site_desc_font_weightSite Description Font-WeightWeight for tagline.Select400 / 700400
site_desc_font_styleSite Description Font-StyleStyle for tagline.Selectnormal / italicnormal
site_desc_line_heightSite Description Line-HeightLine height for tagline.TextNumeric1
menu_fontsMenu Font-FamilyFont for navigation menu.SelectGoogle/system fontsOswald
menu_font_sizeMenu Font-SizeSize for menu items.Select8px–72px13px
menu_font_weightMenu Font-WeightWeight for menu items.Select400 / 700400
menu_font_styleMenu Font-StyleStyle for menu items.Selectnormal / italicnormal
hpost_title_fontsHome/Featured Post Title Font-FamilyFont for featured post titles.SelectGoogle/system fontsPoppins
hpost_title_font_sizeHome/Featured Post Title Font-SizeSize for featured post titles.Select8px–72px20px
hpost_title_font_weightHome/Featured Post Title Font-WeightWeight for featured post titles.Select400 / 700700
hpost_title_font_styleHome/Featured Post Title Font-StyleStyle for featured post titles.Selectnormal / italicnormal
hpost_title_line_heightHome/Featured Post Title Line-HeightLine height for featured post titles.TextNumeric1.2
hpost_title_sm_fontsHome/Featured Small Post Title Font-FamilyFont for smaller featured titles.SelectGoogle/system fontsPoppins
hpost_title_sm_font_sizeHome/Featured Small Post Title Font-SizeSize for small featured titles.Select8px–72px16px
hpost_title_sm_font_weightHome/Featured Small Post Title Font-WeightWeight for small featured titles.Select400 / 700700
hpost_title_sm_font_styleHome/Featured Small Post Title Font-StyleStyle for small featured titles.Selectnormal / italicnormal
hpost_title_sm_line_heightHome/Featured Small Post Title Line-HeightLine height for small featured titles.TextNumeric1.2
hpost_cats_fontsHome/Featured Post Categories Font-FamilyFont for category labels in featured posts.SelectGoogle/system fontsOswald
hpost_cats_font_sizeHome/Featured Post Categories Font-SizeSize for featured category labels.Select8px–72px12px
hpost_cats_font_weightHome/Featured Post Categories Font-WeightWeight for featured category labels.Select400 / 700400
hpost_cats_font_styleHome/Featured Post Categories Font-StyleStyle for featured category labels.Selectnormal / italicnormal
hpost_meta_fontsHome/Featured Post Meta Font-FamilyFont for featured post meta.SelectGoogle/system fontsOswald
hpost_meta_font_sizeHome/Featured Post Meta Font-SizeSize for featured post meta.Select8px–72px12px
hpost_meta_font_weightHome/Featured Post Meta Font-WeightWeight for featured post meta.Select400 / 700400
hpost_meta_font_styleHome/Featured Post Meta Font-StyleStyle for featured post meta.Selectnormal / italicnormal
read_more_fontsRead More Button Font-FamilyFont for read more buttons.SelectGoogle/system fontsOswald
read_more_font_sizeRead More Button Font-SizeSize for read more buttons.Select8px–72px13px
read_more_font_weightRead More Button Font-WeightWeight for read more buttons.Select400 / 700400
read_more_font_styleRead More Button Font-StyleStyle for read more buttons.Selectnormal / italicnormal
post_title_fontsPost Title Font-FamilyFont for single post titles.SelectGoogle/system fontsOswald
post_title_font_sizePost Title Font-SizeSize for single post titles.Select8px–72px26px
post_title_font_weightPost Title Font-WeightWeight for single post titles.Select400 / 700700
post_title_font_stylePost Title Font-StyleStyle for single post titles.Selectnormal / italicnormal
post_title_line_heightPost Title Line-HeightLine height for single post titles.TextNumeric1.2
widget_title_fontsMain/Sidebar Widget Title Font-FamilyFont for widget titles.SelectGoogle/system fontsOswald
widget_title_font_sizeMain/Sidebar Title Font-SizeSize for widget titles.Select8px–72px14px
widget_title_font_weightMain/Sidebar Title Font-WeightWeight for widget titles.Select400 / 700400
widget_title_font_styleMain/Sidebar Title Font-StyleStyle for widget titles.Selectnormal / italicnormal
sidebar_title_line_heightMain/Sidebar Title Line-HeightLine height for widget titles.TextNumeric1
footer_title_fontsFooter Widget Title Font-FamilyFont for footer widget titles.SelectGoogle/system fontsOswald
footer_title_font_sizeFooter Title Font-SizeSize for footer titles.Select8px–72px14px
footer_title_font_weightFooter Title Font-WeightWeight for footer titles.Select400 / 700400
footer_title_font_styleFooter Title Font-StyleStyle for footer titles.Selectnormal / italicnormal
footer_title_line_heightFooter Title Line-HeightLine height for footer titles.TextNumeric1
headings_fontsGeneral Headings Font-FamilyFont for headings (H1–H6).SelectGoogle/system fontsPlayfair Display
headings_line_heightGeneral Headings Line-HeightLine height for headings.TextNumeric1
h1_font_sizeH1 Font-SizeSize for H1 headings.Select8px–72px32px
h1_font_weightH1 Font-WeightWeight for H1 headings.Select400 / 700700
h1_font_styleH1 Font-StyleStyle for H1 headings.Selectnormal / italicnormal
h2_font_sizeH2 Font-SizeSize for H2 headings.Select8px–72px28px
h2_font_weightH2 Font-WeightWeight for H2 headings.Select400 / 700700
h2_font_styleH2 Font-StyleStyle for H2 headings.Selectnormal / italicnormal
h3_font_sizeH3 Font-SizeSize for H3 headings.Select8px–72px24px
h3_font_weightH3 Font-WeightWeight for H3 headings.Select400 / 700700
h3_font_styleH3 Font-StyleStyle for H3 headings.Selectnormal / italicnormal
h4_font_sizeH4 Font-SizeSize for H4 headings.Select8px–72px20px
h4_font_weightH4 Font-WeightWeight for H4 headings.Select400 / 700700
h4_font_styleH4 Font-StyleStyle for H4 headings.Selectnormal / italicnormal
h5_font_sizeH5 Font-SizeSize for H5 headings.Select8px–72px18px
h5_font_weightH5 Font-WeightWeight for H5 headings.Select400 / 700700
h5_font_styleH5 Font-StyleStyle for H5 headings.Selectnormal / italicnormal
h6_font_sizeH6 Font-SizeSize for H6 headings.Select8px–72px16px
h6_font_weightH6 Font-WeightWeight for H6 headings.Select400 / 700700
h6_font_styleH6 Font-StyleStyle for H6 headings.Selectnormal / italicnormal

Header Image Options

Found under AppearanceCustomizeTheme OptionsHeader Image.

Upload and manage a header image that displays at the top of your site. See the Header Image section above for details.

Option ID Option Name Description Control Type Accepted Value Default
header_imageHeader ImageUpload or select an image to display at the top of the site.Image UploadImage fileNone

Header Options

Found under AppearanceCustomizeTheme OptionsHeader Options.

Option ID Option Name Description Control Type Accepted Value Default
enable_fullwidth_headerEnable Full Width HeaderStretch the header area to full width.Checkboxtrue / falsefalse
hide_header_contentHide Header ContentHide logo, site title/description, and header widgets.Checkboxtrue / falsefalse

Layout Options

Found under AppearanceCustomizeTheme OptionsLayout Options.

Option ID Option Name Description Control Type Accepted Value Default
layout_styleLayout StyleSelect overall page layout alignment.Radiocontent-sidebar / sidebar-content / one-columncontent-sidebar
hide_sidebar_one_columnHide Sidebar from One Column LayoutRemove sidebar when using one-column layout.Checkboxtrue / falsefalse

Post Options

Found under AppearanceCustomizeTheme OptionsPost Options.

Option ID Option Name Description Control Type Accepted Value Default
posts_headingHomePage Posts HeadingHeading text shown above posts on home page.TextStringRecent Posts
thumbnail_linkThumbnail LinkLink featured images to their posts.Selectyes / noyes
post_styleNon-Singular Posts StyleLayout style for archives/search/home listings.Selectstandard / standard-2 / list / list-2 / grid / grid-2 / full / featuredlist
read_more_lengthAuto Post Summary LengthNumber of words in auto-generated summary.TextNumeric25
read_more_textRead More TextText for the Read More link/button.TextStringContinue Reading...
hide_posted_dateHide Posted DateToggle display of post date.Checkboxtrue / falsefalse
hide_post_authorHide Post AuthorHide author name on posts.Checkboxtrue / falsefalse
hide_post_categoriesHide Post CategoriesHide categories on posts.Checkboxtrue / falsefalse
hide_post_tagsHide Post TagsHide tags on posts.Checkboxtrue / falsefalse
hide_comments_linkHide Comment LinkHide the comments count/link.Checkboxtrue / falsefalse
hide_post_editHide Post Edit LinkHide edit link for posts.Checkboxtrue / falsefalse
hide_thumbnailHide Thumbnails from Every PageRemove thumbnails globally.Checkboxtrue / falsefalse
hide_thumbnail_singleHide Thumbnails from Posts/PagesHide thumbnails on single posts/pages.Checkboxtrue / falsefalse
hide_post_snippetHide Post SnippetRemove excerpt/snippet from listings.Checkboxtrue / falsefalse
hide_read_more_buttonHide Read More ButtonRemove Read More buttons on archives.Checkboxtrue / falsefalse
hide_share_buttonsHide Share ButtonsHide sharing buttons on posts.Checkboxtrue / falsefalse
hide_author_bio_boxHide Author Bio BoxHide author bio box on single posts.Checkboxtrue / falsefalse
hide_related_postsHide Related PostsHide related posts section.Checkboxtrue / falsefalse
related_posts_headingRelated Posts HeadingHeading text for related posts section.TextStringRelated Articles
related_posts_numberNumber of Related PostsHow many related posts to show.Select4 / 8 / 12 / 164

Social Links Options

Found under AppearanceCustomizeTheme OptionsSocial Links. Enter your social profile URLs and the theme will display the corresponding icons in the header navigation area and optionally in the footer.

Option ID Option Name Description Control Type Accepted Value Default
hide_header_social_buttonsHide Header Social ButtonsHide social icons in the header area.Checkboxtrue / falsefalse
show_footer_social_buttonsShow Footer Social ButtonsDisplay social icons in the footer.Checkboxtrue / falsefalse
twitterlinkTwitter URLLink to your Twitter profile.TextURLNone
facebooklinkFacebook URLLink to your Facebook profile.TextURLNone
googlelinkGoogle Plus URLLink to your Google Plus profile.TextURLNone
pinterestlinkPinterest URLLink to your Pinterest profile.TextURLNone
linkedinlinkLinkedIn URLLink to your LinkedIn profile.TextURLNone
instagramlinkInstagram URLLink to your Instagram profile.TextURLNone
vklinkVK URLLink to your VK profile.TextURLNone
flickrlinkFlickr URLLink to your Flickr profile.TextURLNone
youtubelinkYouTube URLLink to your YouTube channel.TextURLNone
vimeolinkVimeo URLLink to your Vimeo profile.TextURLNone
soundcloudlinkSoundCloud URLLink to your SoundCloud profile.TextURLNone
lastfmlinkLast.fm URLLink to your Last.fm profile.TextURLNone
githublinkGitHub URLLink to your GitHub profile.TextURLNone
bitbucketlinkBitbucket URLLink to your Bitbucket profile.TextURLNone
tumblrlinkTumblr URLLink to your Tumblr blog.TextURLNone
digglinkDigg URLLink to your Digg profile.TextURLNone
deliciouslinkDelicious URLLink to your Delicious profile.TextURLNone
stumblelinkStumbleUpon URLLink to your StumbleUpon profile.TextURLNone
redditlinkReddit URLLink to your Reddit profile.TextURLNone
dribbblelinkDribbble URLLink to your Dribbble profile.TextURLNone
behancelinkBehance URLLink to your Behance profile.TextURLNone
codepenlinkCodePen URLLink to your CodePen profile.TextURLNone
jsfiddlelinkJSFiddle URLLink to your JSFiddle profile.TextURLNone
stackoverflowlinkStack Overflow URLLink to your Stack Overflow profile.TextURLNone
stackexchangelinkStack Exchange URLLink to your Stack Exchange profile.TextURLNone
bsalinkBuySellAds URLLink to your BuySellAds profile.TextURLNone
slidesharelinkSlideShare URLLink to your SlideShare profile.TextURLNone
skypeusernameSkype UsernameYour Skype username.TextUsernameNone
emailaddressEmail AddressEmail address for contact.TextEmailNone
rsslinkRSS Feed URLLink to your RSS feed.TextURLNone

404 Page Options

Found under AppearanceCustomizeTheme Options404 Page.

Option ID Option Name Description Control Type Accepted Value Default
error_404_heading404 Error Page HeadingHeading displayed on the 404 page.TextareaText/HTMLOops! That page can not be found.
error_404_messageError 404 MessageMessage shown on the 404 page.TextareaText/HTMLIt looks like nothing was found at this location. Maybe try one of the links below or a search?

Other Options

Found under AppearanceCustomizeTheme OptionsOther Options.

Option ID Option Name Description Control Type Accepted Value Default
disable_sticky_menuDisable Sticky MenuTurn off sticky behavior for main menu.Checkboxtrue / falsefalse
disable_sticky_sidebarDisable Sticky SidebarTurn off sticky behavior for sidebar.Checkboxtrue / falsefalse
disable_backtotopDisable Back to Top ButtonHide the back-to-top button.Checkboxtrue / falsefalse
enable_widgets_block_editorEnable Gutenberg Widget Block EditorEnable block-based widgets screen.Checkboxtrue / falsefalse
contact_form_emailContact Form Email AddressEmail address to receive contact form messages.TextEmailNone

Reset Settings Options

Below is the complete list of Reset Settings Options available:

Option ID Option Name Description Control Type Accepted Value Default
reset_settingsReset All Theme OptionsReset all NeatMag theme options to their default values.Button (neatmag-reset-button)Trigger resetNone

Performance & SEO Tips

Here are some tips to help you optimize the performance and SEO of your NeatMag PRO website:

  • 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 without losing quality.
  • Use a CDN — A Content Delivery Network like Cloudflare can serve your assets faster from servers around the world.
  • Install an SEO Plugin — Use Yoast SEO or Rank Math to optimize meta titles, descriptions, XML sitemaps, and more.
  • Keep WordPress Updated — Always use the latest version of WordPress, themes, and plugins for security and performance improvements.
  • Minimize Plugins — Only install plugins you genuinely need. Each plugin adds overhead to your site.
  • Use Quality Hosting — Choose a reputable WordPress hosting provider for better server speed and uptime.
  • Set Featured Images — Always set a featured image for every post to ensure proper display across all post styles, widgets, and social media shares.
  • Enable Open Graph — Install an SEO plugin with Open Graph support to ensure proper thumbnails appear when sharing posts on social media.

Translation & RTL

NeatMag PRO 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 neatmag-pro.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:

After translating, save your files as:

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

Place them inside the /languages folder in the theme.

↔️ RTL Language Support

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

FAQ

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

Why is my logo/site icon/header image/background image missing after upgrading to PRO?

When switching from the free to PRO version, you need to manually reupload your Site Logo, Header Image, Site Icon, and Background Image via Appearance → Customize.

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

Go to Appearance → Menus → Manage Locations and reassign your existing menus to the Primary Menu location.

How do I change the post style on the home page?

  1. Go to AppearanceCustomizeTheme OptionsPost Options.
  2. Under Non-Singular Posts Style, select your preferred style (Standard, Standard 2, List, List 2, Grid, Grid 2, Full, Featured).
  3. Save your changes.

How do I hide the sidebar?

  1. Go to AppearanceCustomizeTheme OptionsLayout Options.
  2. Select One Column as the layout style.
  3. Check Hide Sidebar from One Column Layout to completely remove the sidebar.

How do I reset Customizer settings to default?

Go to AppearanceCustomizeTheme OptionsReset Settings, then click the Reset Theme Options button. A confirmation dialog will appear. Confirm the action to reset your WordPress Customizer settings.

Troubleshooting

This section covers common technical problems you may encounter while installing, activating, or customizing the NeatMag PRO theme. If your specific issue isn't listed, you can always reach out to our support team for assistance.

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 to ensure proper thumbnails appear when sharing.

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

This means your hosting has a small file upload limit. Follow this guide to increase it or use cPanel/File Manager to upload the theme.

Images look blurry or cropped incorrectly

After switching themes, you need to regenerate thumbnails. Install the Regenerate Thumbnails plugin and run it from Tools → Regenerate Thumbnails.

Support & Licensing

All our WordPress themes, including NeatMag PRO, are released under the 100% GPL (General Public License). You can use the theme on unlimited websites and modify the code to suit your needs.

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 or would like to request a paid customization, please contact us. We typically respond within 24–48 hours on working days.

Contact Support

Changelog & Versioning

The following is a log of all updates and changes made to NeatMag PRO. We recommend always using the latest version to benefit from improvements and new features.

= 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.0 =

  • Initial Release.

Date Formats

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.

Format KeyExample Output
H:i00:50
g:i a12:50 am
g:i A12:50 AM
g:i:s a12:50:48 am
g:i:s A12:50:48 AM
d.m.y27.11.10
Y.m.d2010.11.27
Y-m-d2010-11-27
Y/m/d2010/11/27
m.d.Y11.27.2010
m-d-Y11-27-2010
m/d/Y11/27/2010
d.m.Y27.11.2010
d-m-Y27-11-2010
d/m/Y27/11/2010
m/d/Y g:i:s a11/27/2010 12:50:48 am
m/d/Y g:i:s A11/27/2010 12:50:48 AM
Y/m/d \a\t g:i a2010/11/27 at 12:50 am
Y/m/d \a\t g:i A2010/11/27 at 12:50 AM
d F27 November
F, YNovember, 2010
F j, YNovember 27, 2010
d M Y27 Nov 2010
M j, YNov 27, 2010
M j, Y @ H:iNov 27, 2010 @ 0:50
l, F j, YSaturday, November 27, 2010
l, F jS, YSaturday, November 27th, 2010