Documentation - PureMag PRO WordPress Theme

Introduction

PureMag PRO is a clean and elegant, easy to use, fully responsive WordPress blogging theme developed by ThemesDNA. Built on the solid foundation of the Underscores starter theme, PureMag PRO delivers a polished, professional blogging experience with extensive customization options. It features a 2-column layout by default with options for left sidebar, right sidebar, or one-column layouts.

The theme comes equipped with 5 different post styles (Standard, List, Grid, Full, and Featured), multiple custom widgets including featured posts widgets, recent/popular/random posts widgets, social links widget, and an about me widget. PureMag PRO offers comprehensive color options, extensive font options with Google Fonts support, share buttons (Twitter, Facebook, Pinterest, Reddit, StumbleUpon, Digg, LinkedIn), related posts, author bio box, custom header image with custom title and description, WooCommerce support, and much more.

Buy PureMag PRO Live Demo

Current Theme Version: 1.0.7

Theme Installation

After purchasing the PureMag 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 PureMag Theme?

PureMag PRO is a separate theme. Whether or not you're currently using the free PureMag theme, you need to install PureMag 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 PureMag 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.

Go to "WordPress Dashboard" → "Appearance" → "Themes" and click on "Add New" button.
Click on "Upload Theme" button and choose the zip file you have downloaded.
Click on "Install Now" button.
Activate the theme.
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.

Log in to your cPanel account. Your cPanel URL will be https://yourdomain.com/cpanel or a similar URL.
Click on the "File Manager" icon. It's usually under the "Files" section.

You are now in the "File Manager". Open the public_html folder, which is your website's root directory.
Locate the wp-content folder inside "public_html," then open the themes folder inside of it.
In the File Manager interface, click the "Upload" button and choose the theme's .zip file from your local drive.
After it has been uploaded, right-click the .zip file and choose "Extract" or "Unzip".
You can now delete the uploaded .zip file, but it's optional.
Log in to your WordPress dashboard through your web browser.
Go to Appearance → Themes. Now you will see the newly extracted theme.
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:

Unzip the theme's .zip file you have downloaded.
Connect to your hosting account using an FTP client such as "FileZilla" or "Core FTP".
Navigate to the /wp-content/themes folder in the "Remote site" section.
In the "Local site" section, locate the unzipped theme folder.
Drag and drop the unzipped theme folder from the "Local site" section to the "Remote site" section.
Be patient and let the transfer finish.
Once the transfer is complete, log in to your WordPress dashboard and navigate to Appearance > Themes.
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 PureMag PRO 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 PureMag 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.

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.

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

Header Image

Quick Start Guide

PureMag PRO allows users to upload a site-wide custom header image with custom title and description. The recommended header image size is 1060 × 200 pixels (flexible height). Options are in Appearance → Customize → Theme Options → Header Image.

How to Add a Header Image?

Go to Appearance → Customize → Theme Options → Header Image
Upload your header image using Add new image button.

How to Add a Custom Title/Description to Header Image?

By default, the theme displays your website's title as the header image title and the tagline as the header image description. You can replace both via the Customizer.

Go to Appearance → Customize → Theme Options → Header Image
Add your custom header image title and description.
Save settings.

How to Hide Title/Description from Header Image?

Go to Appearance → Customize → Site Identity.
Uncheck the option Display Site Title & Tagline and save.

Navigation Menus

This theme includes one Display Location for menus: Primary 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:

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.

Custom Widgets

Quick Start Guide

To see available widgets and widget areas navigate to WordPress Dashboard → Appearance → Widgets. There are 10 custom widgets bundled with PureMag PRO:

PureMag Recent Posts Widget
PureMag Popular Posts Widget
PureMag Random Posts Widget
PureMag Featured Posts Widget 1
PureMag Featured Posts Widget 2
PureMag Featured Posts Widget 3
PureMag Featured Posts Widget 4
PureMag Featured Posts Widget 5
PureMag Social Widget
PureMag About Me Widget

PureMag Recent Posts Widget

Displays a list of your most recent posts with optional thumbnails.

Option ID	Option Name	Description	Control Type	Accepted Value	Default
title	Title	Widget title displayed above the post list.	Text	A plain text.	Recent Posts
numberofposts	Number of posts to show	Number of recent posts to display.	Text	A positive whole number.	5
show_thumbnail	Display Thumbnail?	Show or hide post thumbnails.	Checkbox	true / false	true
show_date	Display Post Date?	Show post publication date.	Checkbox	true / false	true
show_comments	Display Number of Comments?	Show post comment count.	Checkbox	true / false	true
show_snippet	Display Post Snippet?	Show post excerpt/snippet (20 words).	Checkbox	true / false	true

PureMag Popular Posts Widget

Displays a list of your most popular posts sorted by comment count, with optional thumbnails.

Option ID	Option Name	Description	Control Type	Accepted Value	Default
title	Title	Widget title displayed above the post list.	Text	A plain text.	Popular Posts
numberofposts	Number of posts to show	Number of popular posts to display.	Text	A positive whole number.	5
show_thumbnail	Display Thumbnail?	Show or hide post thumbnails.	Checkbox	true / false	true
show_date	Display Post Date?	Show post publication date.	Checkbox	true / false	true
show_comments	Display Number of Comments?	Show post comment count.	Checkbox	true / false	true
show_snippet	Display Post Snippet?	Show post excerpt/snippet (20 words).	Checkbox	true / false	true

PureMag Random Posts Widget

Displays a list of random posts with optional thumbnails. A great way to resurface older content.

Option ID	Option Name	Description	Control Type	Accepted Value	Default
title	Title	Widget title displayed above the post list.	Text	A plain text.	Random Posts
numberofposts	Number of posts to show	Number of random posts to display.	Text	A positive whole number.	5
show_thumbnail	Display Thumbnail?	Show or hide post thumbnails.	Checkbox	true / false	true
show_date	Display Post Date?	Show post publication date.	Checkbox	true / false	true
show_comments	Display Number of Comments?	Show post comment count.	Checkbox	true / false	true
show_snippet	Display Post Snippet?	Show post excerpt/snippet (20 words).	Checkbox	true / false	true

PureMag Featured Posts Widgets (1-5)

PureMag PRO includes 5 featured posts widgets, each with a different layout style. Options vary slightly by style; tables below reflect the actual controls found in each widget.

Featured Posts Widget 1 (Style 1)

Option ID	Option Name	Description	Control Type	Accepted Value	Default
title	Title	Widget title.	Text	A plain text.	Featured Posts - Style 1
post_type	Choose the Post Type to display	Recent / Popular / Random / Category / Tag.	Select	Choices above	Recent Posts
featured_cat	Select a Category	Used when post type is Category Posts.	Select	Category ID	(empty)
featured_tag	Select a Tag	Used when post type is Tag Posts.	Select	Tag ID	(empty)
number	Number of posts to show	Number of posts to display.	Text	A positive whole number.	5
snippet_length	Post snippet length	Words shown in snippet.	Text	A positive whole number.	20
show_thumbnail	Display Post Thumbnail?	Show featured image.	Checkbox	true / false	true
show_date	Display Post Date?	Show publication date.	Checkbox	true / false	true
show_comments	Display Number of Comments?	Show comment count.	Checkbox	true / false	true
show_snippet	Display Post Snippet?	Show excerpt/snippet.	Checkbox	true / false	true

Featured Posts Widget 2 (Style 2)

Option ID	Option Name	Description	Control Type	Accepted Value	Default
title	Title	Widget title.	Text	A plain text.	Featured Posts - Style 2
post_type	Choose the Post Type to display	Recent / Popular / Random / Category / Tag.	Select	Choices above	Recent Posts
featured_cat	Select a Category	Used when post type is Category Posts.	Select	Category ID	(empty)
featured_tag	Select a Tag	Used when post type is Tag Posts.	Select	Tag ID	(empty)
number	Number of posts to show	Number of posts to display.	Text	A positive whole number.	5
snippet_length	Post snippet length	Words shown in snippet.	Text	A positive whole number.	25
show_cats	Display Post Categories?	Show categories above title.	Checkbox	true / false	true
show_date	Display Post Date?	Show publication date.	Checkbox	true / false	true
show_comments	Display Number of Comments?	Show comment count.	Checkbox	true / false	true
show_snippet	Display Post Snippet?	Show excerpt/snippet.	Checkbox	true / false	true

Featured Posts Widget 3 (Style 3)

Option ID	Option Name	Description	Control Type	Accepted Value	Default
title	Title	Widget title.	Text	A plain text.	Featured Posts - Style 3
post_type	Choose the Post Type to display	Recent / Popular / Random / Category / Tag.	Select	Choices above	Recent Posts
featured_cat	Select a Category	Used when post type is Category Posts.	Select	Category ID	(empty)
featured_tag	Select a Tag	Used when post type is Tag Posts.	Select	Tag ID	(empty)
number	Number of posts to show	Number of posts to display.	Text	A positive whole number.	2
snippet_length	Post snippet length	Words shown in snippet.	Text	A positive whole number.	25
readmore_text	Read More Text	Label for the read more link.	Text	A plain text.	Continue Reading...
show_thumbnail	Display Post Thumbnail?	Show featured image.	Checkbox	true / false	true
show_cats	Display Post Categories?	Show categories above title.	Checkbox	true / false	true
show_author	Display Post Author?	Show author name.	Checkbox	true / false	true
show_date	Display Post Date?	Show publication date.	Checkbox	true / false	true
show_comments	Display Number of Comments?	Show comment count.	Checkbox	true / false	true
show_snippet	Display Post Snippet?	Show excerpt/snippet.	Checkbox	true / false	true
show_readmore	Display Read More Button?	Show read more link.	Checkbox	true / false	true

Featured Posts Widget 4 (Style 4)

Option ID	Option Name	Description	Control Type	Accepted Value	Default
title	Title	Widget title.	Text	A plain text.	Featured Posts - Style 4
post_type	Choose the Post Type to display	Recent / Popular / Random / Category / Tag.	Select	Choices above	Recent Posts
featured_cat	Select a Category	Used when post type is Category Posts.	Select	Category ID	(empty)
featured_tag	Select a Tag	Used when post type is Tag Posts.	Select	Tag ID	(empty)
number	Number of posts to show	Number of posts to display.	Text	A positive whole number.	4
snippet_length	Post snippet length	Words shown in snippet.	Text	A positive whole number.	25
readmore_text	Read More Text	Label for the read more link.	Text	A plain text.	Continue Reading...
show_thumbnail	Display Post Thumbnail?	Show featured image.	Checkbox	true / false	true
show_cats	Display Post Categories?	Show categories above title.	Checkbox	true / false	true
show_author	Display Post Author?	Show author name.	Checkbox	true / false	true
show_date	Display Post Date?	Show publication date.	Checkbox	true / false	true
show_comments	Display Number of Comments?	Show comment count.	Checkbox	true / false	true
show_snippet	Display Post Snippet?	Show excerpt/snippet.	Checkbox	true / false	true
show_readmore	Display Read More Button?	Show read more link.	Checkbox	true / false	true

Featured Posts Widget 5 (Style 5)

Option ID	Option Name	Description	Control Type	Accepted Value	Default
title	Title	Widget title.	Text	A plain text.	Featured Posts - Style 5
post_type	Choose the Post Type to display	Recent / Popular / Random / Category / Tag.	Select	Choices above	Recent Posts
featured_cat	Select a Category	Used when post type is Category Posts.	Select	Category ID	(empty)
featured_tag	Select a Tag	Used when post type is Tag Posts.	Select	Tag ID	(empty)
number	Number of posts to show	Number of posts to display.	Text	A positive whole number.	4
snippet_length	Post snippet length	Words shown in snippet.	Text	A positive whole number.	25
readmore_text	Read More Text	Label for the read more link.	Text	A plain text.	Continue Reading...
show_thumbnail	Display Post Thumbnail?	Show featured image.	Checkbox	true / false	true
show_cats	Display Post Categories?	Show categories above title.	Checkbox	true / false	true
show_author	Display Post Author?	Show author name.	Checkbox	true / false	true
show_date	Display Post Date?	Show publication date.	Checkbox	true / false	true
show_comments	Display Number of Comments?	Show comment count.	Checkbox	true / false	true
show_snippet	Display Post Snippet?	Show excerpt/snippet.	Checkbox	true / false	true
show_readmore	Display Read More Button?	Show read more link.	Checkbox	true / false	true

PureMag Social Widget

Displays social media profile links with Font Awesome icons. Supports over 30 platforms including Twitter, Facebook, Google Plus, Pinterest, LinkedIn, Instagram, Flickr, YouTube, Vimeo, SoundCloud, Last.fm, GitHub, Bitbucket, Tumblr, Digg, Delicious, StumbleUpon, Reddit, Dribbble, Behance, CodePen, JSFiddle, Stack Overflow, Stack Exchange, BuySellAds, SlideShare, Skype, Email, and RSS Feed.

Leave any social media field empty to hide that particular button
Skype field requires just the username, not a full URL
Email field requires a valid email address
All other fields should be complete URLs (e.g., https://facebook.com/username)

Option ID	Option Name	Description	Control Type	Accepted Value	Default
title	Title	Widget title.	Text	Plain text	Social Buttons
round_buttons	Display round buttons?	Use circular button style.	Checkbox	true / false	false
facebook	Facebook URL	Profile/page URL.	Text	URL	(empty)
twitter	Twitter URL	Profile URL.	Text	URL	(empty)
googleplus	Google Plus URL	Profile URL.	Text	URL	(empty)
pinterest	Pinterest URL	Profile URL.	Text	URL	(empty)
linkedin	LinkedIn URL	Profile URL.	Text	URL	(empty)
instagram	Instagram URL	Profile URL.	Text	URL	(empty)
flickr	Flickr URL	Profile URL.	Text	URL	(empty)
youtube	YouTube URL	Channel URL.	Text	URL	(empty)
vimeo	Vimeo URL	Profile URL.	Text	URL	(empty)
soundcloud	SoundCloud URL	Profile URL.	Text	URL	(empty)
lastfm	Last.fm URL	Profile URL.	Text	URL	(empty)
github	GitHub URL	Profile URL.	Text	URL	(empty)
bitbucket	Bitbucket URL	Profile URL.	Text	URL	(empty)
tumblr	Tumblr URL	Profile URL.	Text	URL	(empty)
digg	Digg URL	Profile URL.	Text	URL	(empty)
delicious	Delicious URL	Profile URL.	Text	URL	(empty)
stumbleupon	StumbleUpon URL	Profile URL.	Text	URL	(empty)
reddit	Reddit URL	User/profile URL.	Text	URL	(empty)
dribbble	Dribbble URL	Profile URL.	Text	URL	(empty)
behance	Behance URL	Profile URL.	Text	URL	(empty)
codepen	CodePen URL	Profile URL.	Text	URL	(empty)
jsfiddle	JSFiddle URL	Profile URL.	Text	URL	(empty)
stackoverflow	Stack Overflow URL	Profile URL.	Text	URL	(empty)
stackexchange	Stack Exchange URL	Profile URL.	Text	URL	(empty)
buysellads	BuySellAds URL	Profile URL.	Text	URL	(empty)
slideshare	SlideShare URL	Profile URL.	Text	URL	(empty)
skype	Skype Username	Skype username (no URL).	Text	Username	(empty)
envelope	Email Address	Email for mailto link.	Text	Valid email	(empty)
rss	RSS Feed URL	RSS feed link.	Text	URL	(empty)

PureMag About Me Widget

Displays a profile section with an image, description, and social media links. Supports over 30 social platforms with buttons displayed below the profile information.

Option ID	Option Name	Description	Control Type	Accepted Value	Default
title	Title	Widget title.	Text	A plain text.	About Me
image	Profile Image URL	URL of the profile image.	Text	A valid image URL.	(empty)
description	Description	Text description about the person.	Textarea	HTML formatted text.	(empty)

Additionally, the About Me widget includes fields for the same 30+ social platforms as the Social Widget, plus the option to display round buttons.

Widget Areas

There are 10 widget areas in the PureMag PRO theme.

Header Banner
Located in the header area. You can add a "Custom HTML" widget with your banner ad code.
Main Sidebar
The primary sidebar, located on the right (or left, depending on layout setting) of your web page.
Top Widgets (Home Page Only)
Located at the top of the homepage only. Widgets here are only visible on your homepage.
Top Widgets (Every Page)
Located at the top of every page. Widgets here are visible on all pages.
Bottom Widgets (Home Page Only)
Located at the bottom of the homepage only.
Bottom Widgets (Every Page)
Located at the bottom of every page.
Footer 1
Column 1 (left) of the footer.
Footer 2
Column 2 of the footer.
Footer 3
Column 3 of the footer.
Footer 4
Column 4 (right) of the footer.

Custom Page Templates

PureMag PRO includes 7 custom page and post templates:

"Full Width, no sidebar" (Page): Displays page content in full width without any sidebars.
"Full Width, bottom sidebar" (Page): Displays page content in full width with a sidebar below it.
"Left Sidebar" (Page): Shows a sidebar on the left and page content on the right.
"Full Width, no sidebar" (Post): Displays post content in full width without any sidebars.
"Full Width, bottom sidebar" (Post): Displays post content in full width with a sidebar below it.
"Left Sidebar" (Post): Shows a sidebar on the left and post content on the right.
"Sitemap" (Page): Displays a full list of your site's pages, categories, tags, and archives.

How to Assign a Custom Template:

Go to Pages or Posts → Add New or edit an existing page/post.
Look for the Template option:
- In Gutenberg: Click the Page or Post tab in the right sidebar and scroll down to find Template.
- In Classic Editor: Enable Page Attributes box via Screen Options, then use the Template dropdown.
Select the desired template from the list.
Click Publish or Update.

How to Create a Sitemap Page

PureMag PRO includes a built-in Sitemap page template that displays a full, structured list of your site's content.

Go to WordPress Dashboard → Pages → Add New.
Enter a title like Sitemap.
Select the Sitemap template from the Template dropdown.
Click Publish.

What's Included in the Sitemap Page

List of all Pages
List of all Categories and Tags
Monthly Archives
List of all Authors with links to their posts

Customizer Theme Options

To see available WordPress Customizer theme options:

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

Site Identity Options

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. Max width: 350px, max height: 90px.	Media Uploader	Integer (attachment ID)	0 (none)
blogname	Site Title	Main title of the website shown in the header and browser tabs.	Text	A string	"My WordPress Site"
blogdescription	Tagline	Short descriptive sentence shown below the title.	Text	A string	"Just another WordPress site"
display_header_text	Display Site Title & Tagline	Toggles whether the title/tagline are shown on the front-end.	Toggle Switch	true / false	true
site_icon	Site Icon (Favicon)	Image for the favicon (512 × 512 px recommended).	Media Uploader	Integer (attachment ID)	0 (none)

Colors Options

Below is the complete list of Colors Options available. All use a Color Picker and accept hex color codes (e.g., #ffffff):

Option ID	Option Name	Description	Control Type	Accepted Value	Default
body_text_color	Main Text Color	Pick the Main Text Color.	Color Picker	Hex color code	#555555
link_color	Main Link Color	Pick the Main Link Color.	Color Picker	Hex color code	#666666
link_hover_color	Main Link Hover Color	Pick the Main Link Hover Color.	Color Picker	Hex color code	#000000
headings_color	General Headings Color	Pick the General Headings Color.	Color Picker	Hex color code	#111111
menu_bg_color	Menu Background Color	Pick the Menu Background Color.	Color Picker	Hex color code	#ffffff
menu_bd_color	Menu Border Color	Pick the Menu Border Color.	Color Picker	Hex color code	#ececec
menu_color	Menu Link Color	Pick the Menu Link Color.	Color Picker	Hex color code	#333333
menu_hover_color	Menu Link Hover Color	Pick the Menu Link Hover Color.	Color Picker	Hex color code	#ffffff
menu_hover_bg_color	Menu Link Hover Background Color	Pick the Menu Link Hover Background Color.	Color Picker	Hex color code	#000000
submenu_one_bg_color	Sub Menu Background Color	Pick the Sub Menu Background Color.	Color Picker	Hex color code	#f6f6f6
submenu_one_bd_color	Sub Menu Border Color	Pick the Sub Menu Border Color.	Color Picker	Hex color code	#dddddd
menu_icon_color	Responsive Menu Icon Color	Pick the Responsive Menu Icon Color.	Color Picker	Hex color code	#333333
post_title_color	Post Title Color	Pick the Post Title Color.	Color Picker	Hex color code	#000000
post_title_hover_color	Post Title Hover Color	Pick the Post Title Hover Color.	Color Picker	Hex color code	#333333
post_body_link_color	Post Content Link Color	Pick the Post Content Link Color.	Color Picker	Hex color code	#409BD4
post_body_link_hover_color	Post Content Link Hover Color	Pick the Post Content Link Hover Color.	Color Picker	Hex color code	#08ACD5
postcats_color	Post Categories Color	Pick the Post Categories Color.	Color Picker	Hex color code	#ffffff
postcats_bg_color	Post Categories Background Color	Pick the Post Categories Background Color.	Color Picker	Hex color code	#8c2828
postcats_hover_color	Post Categories Hover Color	Pick the Post Categories Hover Color.	Color Picker	Hex color code	#ffffff
postcats_bg_hover_color	Post Categories Hover Background	Pick the Post Categories Hover Background Color.	Color Picker	Hex color code	#000000
post_meta_color	Post Meta Color	Pick the Post Meta Color.	Color Picker	Hex color code	#666666
post_meta_hover_color	Post Meta Hover Color	Pick the Post Meta Hover Color.	Color Picker	Hex color code	#000000
rmore_color	Read More Button Color	Pick the Read More Button Color.	Color Picker	Hex color code	#ffffff
rmore_bg_color	Read More Button Background	Pick the Read More Button Background Color.	Color Picker	Hex color code	#333333
rmore_hover_color	Read More Button Hover Color	Pick the Read More Button Hover Color.	Color Picker	Hex color code	#ffffff
rmore_bg_hover_color	Read More Button Hover Background	Pick the Read More Button Hover Background Color.	Color Picker	Hex color code	#000000
sidebar_bg_color	Posts/Sidebar Widgets Background	Pick the Posts/Sidebar Widgets Background Color.	Color Picker	Hex color code	#ffffff
sidebar_bd_color	Posts/Sidebar Widgets Border	Pick the Posts/Sidebar Widgets Border Color.	Color Picker	Hex color code	#ececec
sidebar_top_bd_color	Posts/Sidebar Widgets Top Border	Pick the Posts/Sidebar Widgets Top Border Color.	Color Picker	Hex color code	#cccccc
sidebar_title_color	Sidebar Title Color	Pick the Sidebar Title Color.	Color Picker	Hex color code	#686868
sidebar_title_bd_color	Sidebar Title Border Color	Pick the Sidebar Title Border Color.	Color Picker	Hex color code	#dfdfdf
sidebar_link_color	Sidebar Link Color	Pick the Sidebar Link Color.	Color Picker	Hex color code	#313131
sidebar_link_hover_color	Sidebar Link Hover Color	Pick the Sidebar Link Hover Color.	Color Picker	Hex color code	#666666
sidebar_list_bd_color	Sidebar List Border Color	Pick the Sidebar List Border Color.	Color Picker	Hex color code	#eeeeee
tag_cloud_color	Tag Cloud Link Color	Pick the Tag Cloud Link Color.	Color Picker	Hex color code	#ffffff
tag_cloud_bg_color	Tag Cloud Link Background	Pick the Tag Cloud Link Background Color.	Color Picker	Hex color code	#888888
tag_cloud_hover_color	Tag Cloud Link Hover Color	Pick the Tag Cloud Link Hover Color.	Color Picker	Hex color code	#ffffff
tag_cloud_hover_bg_color	Tag Cloud Link Hover Background	Pick the Tag Cloud Link Hover Background.	Color Picker	Hex color code	#000000
social_bg_color	Social Buttons Area Background	Pick the Social Buttons Area Background Color.	Color Picker	Hex color code	#000000
social_bd_color	Social Buttons Area Border	Pick the Social Buttons Area Border Color.	Color Picker	Hex color code	#555555
footer_bg_color	Footer Background Color	Pick the Footer Background Color.	Color Picker	Hex color code	#252525
footer_title_color	Footer Title Color	Pick the Footer Title Color.	Color Picker	Hex color code	#ffffff
footer_title_bd_color	Footer Title Border Color	Pick the Footer Title Border Color.	Color Picker	Hex color code	#5A5656
footer_text_color	Footer Text Color	Pick the Footer Text Color.	Color Picker	Hex color code	#cecece
footer_link_color	Footer Link Color	Pick the Footer Link Color.	Color Picker	Hex color code	#dbdbdb
footer_link_hover_color	Footer Link Hover Color	Pick the Footer Link Hover Color.	Color Picker	Hex color code	#ffffff
footer_list_bd_color	Footer List Border Color	Pick the Footer List Border Color.	Color Picker	Hex color code	#353232
cp_bg_color	Copyrights Background Color	Pick the Copyrights Background Color.	Color Picker	Hex color code	#303436
cp_bd_color	Copyrights Border Color	Pick the Copyrights Border Color.	Color Picker	Hex color code	#3D3D3D
cp_color	Copyrights Text Color	Pick the Copyrights Text Color.	Color Picker	Hex color code	#ECFFF1

Font Options

PureMag PRO includes extensive font customization with Google Fonts support. Customize font family, size, weight, style, line height, and text transform for various elements:

Body Font Options

Body Font-Family — Choose a Google Font for body text
Body Font-Size — Set body text font size
Body Font-Weight — 400, 500, or 700
Body Font-Style — Normal or Italic
Body Line-Height — Set the line height

Site Title Font Options

Site Title Font-Family, Font-Size, Font-Weight, Font-Style, Line-Height, Text Transform

Site Description Font Options

Site Description Font-Family, Font-Size, Font-Weight, Font-Style, Line-Height, Text Transform

Menu Font Options

Menu Font-Family, Font-Size, Font-Weight, Font-Style, Text Transform

Post Title Font Options

Post Title Font-Family, Font-Size, Font-Weight, Font-Style, Line-Height, Text Transform

Additional Font Options

Font Subsets — Select which font subsets to load (optimize performance)
Headings Font, Widget Titles Font, Post Meta Font options also available

Header Options

Option ID	Option Name	Description	Control Type	Accepted Value	Default
enable_fullwidth_header	Enable Full Width Header	Enable or disable a full-width header layout that spans the entire browser width.	Checkbox	true / false	false

Layout Options

Option ID	Option Name	Description	Control Type	Accepted Value	Default
layout_style	Layout Style	Select your layout style.	Radio	Content on Left Content on Right One Column	Content on Left
hide_sidebar_one_column	Hide Sidebar from One Column Layout	Hides the sidebar entirely in one-column layout instead of showing it below the content.	Checkbox	true / false	false

Post Options

Option ID	Option Name	Description	Control Type	Accepted Value	Default
posts_heading	HomePage Posts Heading	Heading text displayed above homepage posts.	Text	A plain text.	Recent Posts
thumbnail_link	Thumbnail Link	Link single post thumbnail to its post?	Select	Yes / No	Yes
post_style	Non-Singular Posts Style	Post style for home/categories/tags/archive/search.	Select	Standard List Grid Full Featured	List
read_more_length	Auto Post Summary Length	Number of words in the post summary.	Text	A positive whole number.	25
read_more_text	Read More Text	Customize the read more button text.	Text	A plain text.	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 post author name.	Checkbox	true / false	false
hide_post_categories	Hide Post Categories	Hide post categories.	Checkbox	true / false	false
hide_post_tags	Hide Post Tags	Hide post tags.	Checkbox	true / false	false
hide_comments_link	Hide Comment Link	Hide the comments link.	Checkbox	true / false	false
hide_post_edit	Hide Post Edit Link	Hide the post edit link.	Checkbox	true / false	false
hide_thumbnail	Hide Thumbnails from Every Page	Hide featured images from all pages.	Checkbox	true / false	false
hide_thumbnail_single	Hide Thumbnails from Posts/Pages	Hide featured images from single posts/pages.	Checkbox	true / false	false
hide_post_snippet	Hide Post Snippet	Hide the post excerpt/snippet.	Checkbox	true / false	false
hide_read_more_button	Hide Read More Button	Hide the read more button.	Checkbox	true / false	false
hide_share_buttons	Hide Share Buttons	Hide social share buttons.	Checkbox	true / false	false
hide_author_bio_box	Hide Author Bio Box	Hide the author bio box on single posts.	Checkbox	true / false	false
hide_related_posts	Hide Related Posts	Hide related posts section.	Checkbox	true / false	false
related_posts_number	Number of Related Posts	Number of posts in the related posts area.	Select	4 / 8 / 12 / 16 Posts	4 Posts

Social Links Options

Add social media profile links that appear in the social buttons area. Enter the full URL for each profile. Leave a field empty to hide that button. Supported platforms:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
hide_social_buttons	Hide Social Buttons	Hide the entire social buttons area.	Checkbox	true / false	false
twitterlink	Twitter URL	Twitter profile URL.	Text	A valid URL.	(empty)
facebooklink	Facebook URL	Facebook profile/page 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 URL	LinkedIn profile URL.	Text	A valid URL.	(empty)
instagramlink	Instagram URL	Instagram profile URL.	Text	A valid URL.	(empty)
flickrlink	Flickr URL	Flickr profile URL.	Text	A valid URL.	(empty)
youtubelink	YouTube URL	YouTube channel/profile 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	Last.fm 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 URL	StumbleUpon profile URL.	Text	A valid URL.	(empty)
redditlink	Reddit URL	Reddit profile URL.	Text	A valid URL.	(empty)
dribbblelink	Dribbble URL	Dribbble profile URL.	Text	A valid URL.	(empty)
behancelink	Behance URL	Behance profile URL.	Text	A valid URL.	(empty)
codepenlink	CodePen URL	CodePen profile URL.	Text	A valid URL.	(empty)
jsfiddlelink	JSFiddle URL	JSFiddle profile URL.	Text	A valid URL.	(empty)
stackoverflowlink	Stack Overflow URL	Stack Overflow profile URL.	Text	A valid URL.	(empty)
stackexchangelink	Stack Exchange URL	Stack Exchange profile URL.	Text	A valid URL.	(empty)
bsalink	BuySellAds URL	BuySellAds profile URL.	Text	A valid URL.	(empty)
slidesharelink	SlideShare URL	SlideShare profile URL.	Text	A valid URL.	(empty)
skypeusername	Skype Username	Skype username (not full URL).	Text	A text string.	(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 Options

Option ID	Option Name	Description	Control Type	Accepted Value	Default
footer_text	Footer copyright notice	Custom text displayed in the footer copyright area.	Text	A text/HTML string.	(empty)
hide_footer_widgets	Hide Footer Widgets	Hide the footer widget area entirely.	Checkbox	true / false	false
hide_credit	Hide Theme Designer Credits	Hide the theme designer credit link in the footer.	Checkbox	true / false	false

404 Page Options

Option ID	Option Name	Description	Control Type	Accepted Value	Default
error_404_heading	404 Error Page Heading	The heading displayed on the 404 error page.	Textarea	A text/HTML string.	Oops! That page can not be found.
error_404_message	Error 404 Message	The message displayed on the 404 error page.	Textarea	A text/HTML string.	It looks like nothing was found at this location. Maybe try one of the links below or a search?

Search Page Options

Option ID	Option Name	Description	Control Type	Accepted Value	Default
no_search_heading	No Search Results Heading	Heading displayed when no search results are found.	Textarea	A text/HTML string.	Nothing Found
no_search_results	No Search Results Message	Message displayed when no search results are found.	Textarea	A text/HTML string.	Sorry, but nothing matched your search terms. Please try again with some different keywords.

Other Options

Option ID	Option Name	Description	Control Type	Accepted Value	Default
disable_backtotop	Disable Back to Top Button	Disable the scroll-to-top button that appears at the bottom-right of the page.	Checkbox	true / false	false
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

Reset Settings

Use this control to restore all PureMag PRO Customizer options back to their defaults.

Option ID	Option Name	Description	Control Type	Accepted Value	Default
reset_settings	Reset Settings	Resets all theme options to default values when the reset button is clicked.	Reset Button	Button action	(none)

Performance & SEO Tips

Here are some tips to help you get the best performance and SEO results with PureMag PRO:

Use a Caching Plugin: Install a caching plugin like W3 Total Cache, WP Super Cache, or LiteSpeed Cache to significantly improve your site's loading speed.
Optimize Images: Use an image optimization plugin like Imagify or EWWW Image Optimizer to compress images without losing quality.
Use an SEO Plugin: Install Yoast SEO or Rank Math to help with on-page SEO, meta tags, sitemaps, and Open Graph tags for social media sharing.
Enable GZIP Compression: Most caching plugins offer GZIP compression. Enabling it can reduce file sizes by up to 70%.
Use a CDN: Consider using a Content Delivery Network (CDN) like Cloudflare to serve your static assets from servers closer to your visitors.
Minimize Plugins: Only install the plugins you truly need. Each plugin adds processing overhead.
Use Quality Hosting: A quality hosting provider makes a significant difference in site speed and reliability.
Set Featured Images: Always set a featured image for each post to ensure proper thumbnails appear in widgets, archives, and social media sharing.
Keep WordPress Updated: Always update WordPress core, themes, and plugins to their latest versions for security and performance improvements.

Translation & RTL

PureMag 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 puremag-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:

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

After translating, save your files as:

puremag-pro-[language_code].po
puremag-pro-[language_code].mo

Place them inside the /languages folder in the theme.

↔️ RTL Language Support

PureMag 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

Quick answers to the most frequently asked questions about using PureMag PRO. If you can't find your answer here, contact our support team.

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 correct theme locations.

How do I change the post listing style?

Go to Appearance → Customize → Theme Options → Post Options. Under Non-Singular Posts Style, choose from Standard, List, Grid, Full, or Featured.

How do I change the layout direction?

Go to Appearance → Customize → Theme Options → Layout Options. Select Content on Left, Content on Right, or One Column.

How do I reset Customizer settings to default?

Go to Appearance → Customize → Theme Options → Other Options, then click the Reset Theme Options button. A confirmation dialog will appear. Confirm the action to reset your WordPress Customizer settings.

How do I hide the theme designer credits in the footer?

Go to Appearance → Customize → Theme Options → Footer. Check the Hide Theme Designer Credits option and publish.

Troubleshooting

Common technical problems you may encounter while using PureMag PRO. 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

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.

Featured images look stretched or cropped incorrectly

Regenerate your thumbnails using the Regenerate Thumbnails plugin. See the Regenerate Thumbnails section for instructions.

Custom widgets are not showing

Make sure you have placed your widgets in the correct widget areas via Appearance → Widgets. Also verify that you haven't checked any "hide" options in the Customizer that might be hiding those elements.

Support & Licensing

All our WordPress themes, including PureMag 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 PureMag PRO. We recommend always using the latest version to benefit from improvements and new features.

= Version 1.0.7 =

Fixed coding issues.

= Version 1.0.6 =

Fixed coding issues.
Theme Customizer updated.
Many improvements.

= 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.
Many improvements.

= Version 1.0.1 =

Fixed coding issues.

= Version 1.0.0 =

Initial Release.

Introduction

Theme Installation

Upgrading from the Free PureMag Theme?

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

Method 2: Install using cPanel File Manager

Method 3: Install using FTP

Troubleshooting Tips

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

Quick Start Guide

How to Add a Header Image?

How to Add a Custom Title/Description to Header Image?

How to Hide Title/Description from Header Image?

Navigation Menus

Custom Widgets

Quick Start Guide

PureMag Recent Posts Widget

PureMag Popular Posts Widget

PureMag Random Posts Widget

PureMag Featured Posts Widgets (1-5)

Featured Posts Widget 1 (Style 1)

Featured Posts Widget 2 (Style 2)

Featured Posts Widget 3 (Style 3)

Featured Posts Widget 4 (Style 4)

Featured Posts Widget 5 (Style 5)

PureMag Social Widget

PureMag About Me Widget

Widget Areas

Header Banner

Main Sidebar

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

Custom Page Templates

How to Assign a Custom Template:

How to Create a Sitemap Page

What's Included in the Sitemap Page

Customizer Theme Options

Site Identity Options

Colors Options

Font Options

Body Font Options

Site Title Font Options

Site Description Font Options

Menu Font Options

Post Title Font Options

Additional Font Options

Header Options

Layout Options

Post Options

Social Links Options

Footer Options

404 Page Options

Search Page Options

Other Options

Reset Settings

Performance & SEO Tips

Translation & RTL

🌐 Translating the Theme

↔️ RTL Language Support

FAQ

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

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

How do I change the post listing style?

How do I change the layout direction?

How do I reset Customizer settings to default?

How do I hide the theme designer credits in the footer?

Troubleshooting

Post thumbnails are missing when sharing on social media

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