Documentation - WP Masonry PRO WordPress Theme

Introduction

WP Masonry PRO is a sophisticated WordPress theme by ThemesDNA designed to showcase content through a modern Masonry grid layout. Emphasizing a clean and minimalistic aesthetic, this responsive theme ensures your posts and pages are displayed elegantly across all devices. Enhancements such as sticky menus, sidebars, and customizable footers support seamless navigation, while features like social buttons and scroll-to-top functionality enrich user interaction.

The PRO version expands on the free theme’s functionalities by offering extensive customization options including multiple grid layouts with up to five columns and various thumbnail styles to tailor post presentations. It supports dual navigation menus, versatile header configurations, and advanced widgets such as featured posts, news tickers, and social profiles, enhancing both the appearance and usability of your site. With additional built-in tools like a contact form and related posts with thumbnails, WP Masonry PRO caters comprehensively to professional bloggers and content creators.

This theme accommodates different layout preferences for singular and non-singular pages and offers a rich selection of custom page and post templates. Its user-friendly theme options allow easy management of colors, fonts, and site structure, making it ideal for users seeking both flexibility and visual appeal. WP Masonry PRO represents a robust solution for those wanting a distinctive grid-based WordPress theme that balances functionality with style.

You can explore the theme live, purchase it, or view a full homepage screenshot using the buttons below:

Buy WP Masonry PRO Live Demo View Screenshot

Current Theme Version: 1.0.6

Theme Installation

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

WP Masonry PRO is a separate theme. Whether or not you're currently using the free WP Masonry theme, you need to install WP Masonry 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 WP Masonry 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 WP Masonry PRO theme demo using one of the two methods below.

Manual Demo Import

You can also import the content, widgets, and Customizer settings manually by following these three steps:

Step 1: Import Main Site Content

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

Download Content File: Download XML File
Go to Tools → Import.
Under "WordPress", click Install Now if not already installed.
Click Run Importer.
Select the downloaded XML file and click Upload file and import.
Map authors to users, check "Download and import file attachments", and click Submit.

Step 2: Import Widgets

Install and activate the Widget Display Conditions plugin (optional, for visibility control).
Install and activate the Widget Importer & Exporter plugin.
Go to Tools → Widget Importer & Exporter.
Click the "copy and paste" link to open a textarea.
Copy content from: Widgets .wie File and paste into the box.
Click Import Widgets.

Step 3: Import Customizer Settings

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

Regenerate Thumbnails

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

Header Image

Quick Start Guide

WP Masonry PRO theme allows users to upload their very own site-wide custom header image with custom title and description to obtain a much more personalized look and feel. Also they can upload an unique header image for each post/page with unique title and description replacing the site-wide header image and its title/description.

There are many header image options in WP Masonry PRO:

Header image options in Theme Customizer
Header image options in post edit screen
Header image options in page edit screen

How to Add a Header Image?

There are 3 types of header images in this theme:

Site-wide Header Image : Appearance → Customize → Theme Options → Header Image
Header Images of Posts : Post’s Edit Screen → “Post Settings – WP Masonry PRO” Meta Box → Site Header Image
Header Images of Pages : Page’s Edit Screen → “Page Settings – WP Masonry PRO” Meta Box → Site Header Image

How to Add a Site-wide Header Image?

Site-wide header image will be displayed everywhere on your website. But if you add a header image to a post/page using settings of that post/page, site-wide header image will be replaced by that header image.

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

How to Add a Header Image to a Post?

You can set a different header image for each post.

To set a header image to a post, go to edit screen of that post.
Find the Post Settings - WP Masonry PRO meta box.
Add your image URL or upload an image using Site Header Image option.

How to Add a Header Image to a Page?

You can set a different header image for each page. To set a header image to a page, go to edit screen of that page. Find the Page Settings - WP Masonry PRO meta box.
Add your image URL or upload an image using Site Header Image option.

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. However, you can replace both with custom title and description.

First, you need to enable the display of custom header image title and description sitewide. To do this, go to Appearance → Customize → Theme Options → Header Image and check the option Add Custom Title/Custom Description to Header Image and save settings.

Add a Custom Title/Description to Site-wide Header Image:

Go to Appearance → Customize → Theme Options → Header Image
Add your custom header image title to Header Image Custom Title text field.
Add your custom header image description title to Header Image Custom Description text field.
Save settings.

How to Add a Custom Title/Description to the Header Image of a Post?

You can assign a unique title and description to the header image of each post. These will override the sitewide header image title and description.

Go to the edit screen of that post.
Find the Post Settings - WP Masonry PRO meta box.
Use Site Header Image Title and Site Header Image Description options for adding a title and a description.
Update the post.

How to Add a Custom Title and Description to the Header Image of a Page?

You can assign a unique title and description to the header image of each page. These will override the sitewide header image title and description.

Go to the edit screen of that page.
Find the Page Settings - WP Masonry PRO meta box.
Use Site Header Image Title and Site Header Image Description options for adding a title and a description.
Update the page.

How to Hide Title/Description from Header Image?

Go to Appearance → Customize → Theme Options → Header Image.
Check the option Hide both Title and Description from Header Image and save settings.
Save settings.

Note: This option will hide both header image title and header image description sitewide.

How to Change Linked URL of Header Image?

By default, the theme's header image links to the home URL. You can change this to a different URL through the theme options.

Change Linked URL of Site-wide Header Image:

Go to Appearance → Customize → Theme Options → Header Image
Add your own header image link to Header Image Destination URL text field.
Save settings.

Change Linked URL of the Header Image of a Post:

Go to the edit screen of that post.
Find the Post Settings - WP Masonry PRO meta box.
Use Site Header Image Destination URL option to add your own header image link.
Update the post.

Change Linked URL of the Header Image of a Page:

Go to the edit screen of that page.
Find the Page Settings - WP Masonry PRO meta box.
Use Site Header Image Destination URL option to add your own header image link.
Update the page.

Navigation Menus

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

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

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.

News Ticker

The News Ticker in the WP Masonry PRO theme is a lightweight, eye-catching feature that displays your posts in a smooth, horizontal scrolling format at the top of your site. It's perfect for highlighting breaking news, trending updates, or featured content with a continuous stream of headlines that captures visitors' attention. Fully customizable via the WordPress Theme Customizer, you can easily enable or disable the ticker, set a custom label, define the number of posts to display, and filter content by recent posts, a specific category, a specific tag, or manually entered post IDs. This feature adds a dynamic touch to your website while keeping readers informed of key updates.

How to Configure the News Ticker

You can activate and customize it via the WordPress Theme Customizer.

Step 1: Access the News Ticker Options

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

Step 2: Enable the News Ticker

Find the option Enable News Ticker and toggle the switch to Yes to activate the news ticker on your site.

Step 3: Configure Ticker Options

👉 Check the complete list of "News Ticker Options" available

Step 4: Save Changes

Once you've configured the settings, click the Publish button at the top of the Customizer to apply the changes.

Tips

Use Posts by IDs to curate exactly which headlines appear.
Use Tag Posts or Category Posts for automated updates within a topic.
Adjust duration and width values for responsiveness and readability.

Custom Widgets

Quick Start Guide

To see available widgets and widget areas please navigate to WordPress Dashboard → Appearance → Widgets. You can drag and drop widgets into widget areas you like. Widgets page will look like this: WP Masonry PRO Widgets and Widget Areas

There are 6 custom widgets bundled with the WP Masonry PRO theme.

WP Masonry Featured Posts - Style 1
WP Masonry Featured Posts - Style 2
WP Masonry Tabbed Widget
WP Masonry About Widget
WP Masonry Social Buttons

WP Masonry Featured Posts Widget - Style 1

Key Features

Multiple Post Sources: Display posts from recent, popular, random, category-specific, or tag-specific sources
Flexible Display Options: Control thumbnail visibility, author information, dates, comments count, and post snippets
Responsive Design: Automatically adapts to different screen sizes with masonry layout
Customizable Snippets: Adjustable excerpt length with word count control
Built-in Fallback Images: Shows default thumbnail when posts don't have featured images

This widget displays a list of posts in a clean, vertical layout. You can choose to show recent posts, popular posts (by comment count), random posts, posts from a specific category, or posts with a specific tag. Each post item can display a thumbnail, title, author, date, comment count, and a text snippet.

Below is the complete list of options available in the "WP Masonry Featured Posts Widget - Style 1":

Option ID	Option Name	Description	Control Type	Accepted Value	Default
title	Title	Widget title displayed above the post list.	Text	Any text string.	Featured Posts - Style 1
post_type	Choose the Post Type to display	Determines the source and sorting of posts to display.	Select	One of the values below: Recent Posts Popular Posts Random Posts Category Posts Tag Posts	Recent Posts
featured_cat	Select a Category (If post type option is Category Posts)	When "Category Posts" is selected, chooses which category to pull posts from.	Category Dropdown	A WordPress category ID.	(empty)
featured_tag	Select a Tag (If post type option is Tag Posts)	When "Tag Posts" is selected, chooses which tag to pull posts from.	Tag Dropdown	A WordPress tag ID.	(empty)
number	Number of posts to show	Number of posts to display in the widget.	Text	A positive whole number.	5
snippet_length	Post snippet length (number of words)	When post snippets are enabled, controls how many words to show from the post content.	Text	A positive whole number.	20
show_thumbnail	Display Post Thumbnail?	Shows the featured image for each post. Uses a fallback image if no featured image is set.	Checkbox	true / false	true
show_author	Display Post Author?	Shows the author name with link to author archive.	Checkbox	true / false	false
show_date	Display Post Date?	Shows the publication date in YYYY-MM-DD format.	Checkbox	true / false	true
show_comments	Display Number of Comments?	Shows the comment count with link to comments section.	Checkbox	true / false	true
show_snippet	Display Post Snippet?	Shows an excerpt from the post content, truncated to the specified word length.	Checkbox	true / false	true

Usage Notes

Post Sources Behavior:
- Recent Posts: Shows latest published posts in descending order by date.
- Popular Posts: Orders posts by comment count (highest to lowest).
- Random Posts: Displays posts in random order on each page load.
- Category Posts: Only shows posts from the selected category.
- Tag Posts: Only shows posts with the selected tag.
Thumbnail Display: Thumbnails use the 'wp-masonry-mini-image' image size. If a post has no featured image, a default "no-image-small.png" from the theme's assets folder will be shown.
Date Format: The date is displayed in "Y-m-d" (e.g., 2025-03-15) format and cannot be changed via widget settings.
Sticky Posts: Sticky posts are ignored in all query types to maintain consistent widget behavior.
Performance Note: The "Random Posts" option may have performance implications on sites with large post databases as it uses MySQL's ORDER BY RAND().
Category/Tag Selection: The category and tag dropdowns only appear relevant options when their respective post types are selected.

WP Masonry Featured Posts Widget - Style 2

Key Features

Displays posts in a responsive masonry grid layout with multiple column options (2-5 columns)
Multiple post source options: Recent, Popular, Random, Category-based, or Tag-based posts
Four thumbnail style options: Horizontal, Square, Vertical, or Auto Height
Comprehensive display controls for thumbnails, metadata, snippets, and share buttons
Built-in fallback system for posts without featured images
Fully responsive design that adapts to different screen sizes

This widget displays posts in a responsive masonry grid layout based on recent posts, popular posts (by comment count), random posts, posts from a selected category, or posts with a specific tag. The widget features multiple column layouts and thumbnail style options.

Below is the complete list of options available in the "WP Masonry Featured Posts Widget - Style 2":

Option ID	Option Name	Description	Control Type	Accepted Value	Default
title	Title	Widget title displayed above the post grid.	Text	A plain text.	Featured Posts - Style 2
post_column	Choose Posts Columns Style	Number of columns in the masonry grid layout.	Select	One of the values below: wp-masonry-2-col (2 Columns) wp-masonry-3-col (3 Columns) wp-masonry-4-col (4 Columns) wp-masonry-5-col (5 Columns)	wp-masonry-3-col
thumb_style	Choose Thumbnail Style	Aspect ratio and styling for post thumbnails.	Select	One of the values below: wp-masonry-horizontal-image (Horizontal Thumbnails) wp-masonry-square-image (Square Thumbnails) wp-masonry-vertical-image (Vertical Thumbnails) wp-masonry-hauto-image (Auto Height Thumbnails)	wp-masonry-square-image
post_type	Choose the Post Type to display	Source and filtering method for posts.	Select	One of the values below: recentposts (Recent Posts) popularposts (Popular Posts - by comment count) randomposts (Random Posts) catposts (Category Posts) tagposts (Tag Posts)	recentposts
featured_cat	Select a Category (If post type option is "Category Posts")	Category to filter posts (only used when post_type is "catposts").	Category Dropdown	A category ID from your WordPress categories.	(empty)
featured_tag	Select a Tag (If post type option is "Tag Posts")	Tag to filter posts (only used when post_type is "tagposts").	Tag Dropdown	A tag ID from your WordPress tags.	(empty)
number	Number of posts to show	Total number of posts to display in the grid.	Text	A positive whole number.	6
snippet_length	Post snippet length (number of words)	Number of words to show in the post excerpt/snippet.	Text	A positive whole number.	20
show_thumbnail	Display Post Thumbnail?	Show or hide the post featured image.	Checkbox	true / false	true
show_cats	Display Post Categories?	Show or hide the post categories.	Checkbox	true / false	true
show_author	Display Post Author?	Show or hide the post author name.	Checkbox	true / false	true
show_date	Display Post Date?	Show or hide the post publication date.	Checkbox	true / false	true
show_comments	Display Number of Comments?	Show or hide the post comment count.	Checkbox	true / false	true
show_snippet	Display Post Snippet?	Show or hide the post excerpt/snippet.	Checkbox	true / false	false
show_share	Display Share Buttons?	Show or hide social sharing buttons.	Checkbox	true / false	true

Usage Notes

Post Source Selection: When selecting "Category Posts" or "Tag Posts", remember to also select the specific category or tag from the corresponding dropdown menus. These options are ignored for other post types.
Thumbnail Fallback: The widget automatically displays a placeholder image when a post doesn't have a featured image. The placeholder changes based on the selected thumbnail style (horizontal, square, or vertical).
Performance Considerations: Using the "Popular Posts" option (ordered by comment count) or "Random Posts" option may have performance implications on sites with large databases. Consider caching strategies for optimal performance.
Responsive Behavior: The masonry grid automatically adjusts based on screen size. On smaller screens, fewer columns may be displayed regardless of the selected column setting.
Share Buttons Dependency: The share buttons functionality requires the wp_masonry_mini_share_buttons() function to be defined elsewhere in the theme. If this function doesn't exist, the share buttons won't display.
Post Snippet Source: The post snippet is generated from the post content using wp_trim_words(get_the_content(), $snippet_length, '...'), not from the post excerpt field.
Sticky Posts: The widget excludes sticky posts from all queries (via ignore_sticky_posts=1).

WP Masonry Tabbed Widget

This widget displays posts in a tabbed format with three distinct tabs: Popular Posts (based on comment count), Recent Posts (based on publication date), and Random Posts. Each tab can be independently enabled or disabled, and the display of various post elements can be customized.

Key Features

Three Tab Types: Popular (most commented), Recent (newest), and Random posts
Flexible Configuration: Each tab can be individually enabled/disabled
Customizable Tab Names: Rename each tab to match your site's terminology
Display Options: Control which post elements to show (thumbnail, author, date, comments, snippet)
Thumbnail Support: Displays featured images with fallback to default image
Snippet Control: Configure the length of post content preview

Usage Notes

Tab Visibility: At least one tab must be enabled for the widget to display content
Popular Posts Logic: Popular posts are determined by comment count (highest first)
Thumbnail Size: Uses the 'wp-masonry-mini-image' image size - ensure this size is registered in your theme
Fallback Image: If no featured image is set, displays a default image from /assets/images/no-image-small.png
Performance: Random posts tab may have slight performance impact on sites with large post databases
Sticky Posts: Sticky posts are excluded from all queries (ignore_sticky_posts=1)

Below is the complete list of options available in the "WP Masonry Tabbed Widget":

Option ID	Option Name	Description	Control Type	Accepted Value	Default
title	Title	Widget title displayed above the tabbed interface.	Text	Any text string.	Tabbed Widget
show_popular_posts	Display Tab 1 (Popular Posts)	Enable or disable the Popular Posts tab.	Checkbox	true / false	true
show_recent_posts	Display Tab 2 (Recent Posts)	Enable or disable the Recent Posts tab.	Checkbox	true / false	true
show_random_posts	Display Tab 3 (Random Posts)	Enable or disable the Random Posts tab.	Checkbox	true / false	true
tab_one_name	Tab 1 Name	Custom name for the first tab (Popular Posts).	Text	Any text string.	Popular
tab_two_name	Tab 2 Name	Custom name for the second tab (Recent Posts).	Text	Any text string.	Recent
tab_three_name	Tab 3 Name	Custom name for the third tab (Random Posts).	Text	Any text string.	Random
number	Number of posts to show	Number of posts displayed in each tab.	Text	A positive whole number.	3
show_thumbnail	Display Post Thumbnail?	Show post featured images.	Checkbox	true / false	true
show_author	Display Post Author?	Show post author name with link to author archive.	Checkbox	true / false	false
show_date	Display Post Date?	Show post publication date.	Checkbox	true / false	true
show_comments	Display Number of Comments?	Show comment count with link to comments section.	Checkbox	true / false	true
show_snippet	Display Post Snippet?	Show excerpt from post content.	Checkbox	true / false	true
snippet_length	Post snippet length (number of words)	Number of words to display in the post snippet.	Text	A positive whole number.	20

Tab Content Details

Tab	Query Parameter	Sort Order	Description
Tab 1 (Popular)	orderby=comment_count	Descending (highest comment count first)	Displays posts with the most comments
Tab 2 (Recent)	orderby=date	Descending (newest first)	Displays most recently published posts
Tab 3 (Random)	orderby=rand	Random	Disposts posts in random order

Common Parameters Applied to All Tabs

posts_per_page: Set by the "Number of posts to show" option
nopaging=0: Disables pagination
post_status=publish: Only shows published posts
ignore_sticky_posts=1: Excludes sticky posts from results
post_type=post: Only includes standard posts (not pages or custom post types)

WP Masonry About Widget

This widget displays an "About Me" section with a profile image, personal description, and extensive social media links. It's designed for personal blogs, portfolio sites, or any website where you want to introduce yourself to visitors.

Key Features

Display a custom profile image with automatic alt text
Add a detailed personal or professional description with HTML support
Include links to 30+ different social media platforms
Choose between round or normal social button styles
Properly sanitized inputs for security
Responsive design ready
Uses Font Awesome icons for social media buttons
Links open in new tabs with nofollow attributes for SEO

Usage Notes

Ensure Font Awesome is enqueued in your theme for social icons to display properly
For profile images, use optimized, square images for best results
The description field supports HTML tags (with security filtering)
Social media links require full URLs (e.g., https://facebook.com/username)
Email and Skype links use appropriate protocols (mailto: and skype:)
All social links include target="_blank" and rel="nofollow" attributes
Round buttons option adds circular styling to social media icons

Below is the complete list of options available in the "WP Masonry About Widget":

Option ID	Option Name	Description	Control Type	Accepted Value	Default
title	Title	Widget title displayed above the about section.	Text	Plain text	About Me
image	Profile Image URL	URL to your profile image. Will be displayed above the description.	Text (URL)	Valid image URL	(empty)
description	Description	Personal or professional description about yourself. Supports HTML.	Textarea	Text with basic HTML tags	(empty)
round_buttons	Display round social buttons?	Toggles between round and normal social media button styles.	Checkbox	true / false	false
facebook	Facebook URL	Your Facebook profile or page URL.	Text (URL)	Valid URL	(empty)
twitter	Twitter URL	Your Twitter profile URL.	Text (URL)	Valid URL	(empty)
googleplus	Google Plus URL	Your Google Plus profile URL.	Text (URL)	Valid URL	(empty)
pinterest	Pinterest URL	Your Pinterest profile URL.	Text (URL)	Valid URL	(empty)
linkedin	LinkedIn URL	Your LinkedIn profile URL.	Text (URL)	Valid URL	(empty)
instagram	Instagram URL	Your Instagram profile URL.	Text (URL)	Valid URL	(empty)
flickr	Flickr URL	Your Flickr profile URL.	Text (URL)	Valid URL	(empty)
youtube	YouTube URL	Your YouTube channel URL.	Text (URL)	Valid URL	(empty)
vimeo	Vimeo URL	Your Vimeo profile URL.	Text (URL)	Valid URL	(empty)
soundcloud	SoundCloud URL	Your SoundCloud profile URL.	Text (URL)	Valid URL	(empty)
lastfm	Last.fm URL	Your Last.fm profile URL.	Text (URL)	Valid URL	(empty)
github	GitHub URL	Your GitHub profile URL.	Text (URL)	Valid URL	(empty)
bitbucket	Bitbucket URL	Your Bitbucket profile URL.	Text (URL)	Valid URL	(empty)
tumblr	Tumblr URL	Your Tumblr blog URL.	Text (URL)	Valid URL	(empty)
digg	Digg URL	Your Digg profile URL.	Text (URL)	Valid URL	(empty)
delicious	Delicious URL	Your Delicious profile URL.	Text (URL)	Valid URL	(empty)
stumbleupon	StumbleUpon URL	Your StumbleUpon profile URL.	Text (URL)	Valid URL	(empty)
reddit	Reddit URL	Your Reddit profile URL.	Text (URL)	Valid URL	(empty)
dribbble	Dribbble URL	Your Dribbble profile URL.	Text (URL)	Valid URL	(empty)
behance	Behance URL	Your Behance portfolio URL.	Text (URL)	Valid URL	(empty)
vk	VK URL	Your VK (VKontakte) profile URL.	Text (URL)	Valid URL	(empty)
codepen	CodePen URL	Your CodePen profile URL.	Text (URL)	Valid URL	(empty)
jsfiddle	JSFiddle URL	Your JSFiddle profile URL.	Text (URL)	Valid URL	(empty)
stackoverflow	Stack Overflow URL	Your Stack Overflow profile URL.	Text (URL)	Valid URL	(empty)
stackexchange	Stack Exchange URL	Your Stack Exchange profile URL.	Text (URL)	Valid URL	(empty)
buysellads	BuySellAds URL	Your BuySellAds profile URL.	Text (URL)	Valid URL	(empty)
slideshare	SlideShare URL	Your SlideShare profile URL.	Text (URL)	Valid URL	(empty)
skype	Skype Username	Your Skype username (not full URL).	Text	Skype username	(empty)
envelope	Email Address	Your email address for contact.	Text (Email)	Valid email address	(empty)
rss	RSS Feed URL	URL to your RSS feed.	Text (URL)	Valid URL	(empty)

WP Masonry Social Buttons Widget

This widget displays a collection of social media buttons with clickable links to your social media profiles. It supports 28 different social networks and provides an option to display buttons as either round or normal icons. Each button opens its respective social media link in a new browser tab.

Key Features

Supports 28+ social media platforms including Facebook, Twitter, Instagram, LinkedIn, YouTube, and more
Option to display buttons as round or normal icons
Built with Font Awesome icons for consistent styling
All links open in new tabs with nofollow attributes for SEO
Email and Skype links use appropriate protocols (mailto: and skype:)
Proper URL sanitization and validation for security
Responsive design ready

Usage Notes

Enter the full URL to your social media profile (e.g., https://facebook.com/yourprofile)
For email, enter only the email address (e.g., contact@example.com)
For Skype, enter only the Skype username (e.g., yourusername)
The RSS field accepts any valid RSS feed URL
All social links are marked with `rel="nofollow"` for SEO purposes
Icons display only if their corresponding field has a value
Ensure Font Awesome is enqueued in your theme for icons to display properly

Below is the complete list of options available in the "WP Masonry Social Buttons Widget":

Option ID	Option Name	Description	Control Type	Accepted Value	Default
title	Title	Widget title displayed above the social buttons.	Text	Plain text	Social Buttons
round_buttons	Display round buttons?	Toggle between round and normal icon styles.	Checkbox	true / false	false
facebook	Facebook	URL to your Facebook profile/page.	Text (URL)	Valid URL	(empty)
twitter	Twitter	URL to your Twitter profile.	Text (URL)	Valid URL	(empty)
googleplus	Google Plus	URL to your Google+ profile (deprecated but supported).	Text (URL)	Valid URL	(empty)
pinterest	Pinterest	URL to your Pinterest profile.	Text (URL)	Valid URL	(empty)
linkedin	Linkedin	URL to your LinkedIn profile.	Text (URL)	Valid URL	(empty)
instagram	Instagram	URL to your Instagram profile.	Text (URL)	Valid URL	(empty)
flickr	Flickr	URL to your Flickr profile.	Text (URL)	Valid URL	(empty)
youtube	Youtube	URL to your YouTube channel.	Text (URL)	Valid URL	(empty)
vimeo	Vimeo	URL to your Vimeo profile.	Text (URL)	Valid URL	(empty)
soundcloud	SoundCloud	URL to your SoundCloud profile.	Text (URL)	Valid URL	(empty)
lastfm	Lastfm	URL to your Last.fm profile.	Text (URL)	Valid URL	(empty)
github	Github	URL to your GitHub profile.	Text (URL)	Valid URL	(empty)
bitbucket	Bitbucket	URL to your Bitbucket profile.	Text (URL)	Valid URL	(empty)
tumblr	Tumblr	URL to your Tumblr blog.	Text (URL)	Valid URL	(empty)
digg	Digg	URL to your Digg profile.	Text (URL)	Valid URL	(empty)
delicious	Delicious	URL to your Delicious profile.	Text (URL)	Valid URL	(empty)
stumbleupon	Stumbleupon	URL to your StumbleUpon profile.	Text (URL)	Valid URL	(empty)
reddit	Reddit	URL to your Reddit profile.	Text (URL)	Valid URL	(empty)
dribbble	Dribbble	URL to your Dribbble profile.	Text (URL)	Valid URL	(empty)
behance	Behance	URL to your Behance profile.	Text (URL)	Valid URL	(empty)
vk	VK	URL to your VK (VKontakte) profile.	Text (URL)	Valid URL	(empty)
codepen	Codepen	URL to your CodePen profile.	Text (URL)	Valid URL	(empty)
jsfiddle	JSFiddle	URL to your JSFiddle profile.	Text (URL)	Valid URL	(empty)
stackoverflow	Stack Overflow	URL to your Stack Overflow profile.	Text (URL)	Valid URL	(empty)
stackexchange	Stack Exchange	URL to your Stack Exchange profile.	Text (URL)	Valid URL	(empty)
buysellads	BuySellAds	URL to your BuySellAds profile.	Text (URL)	Valid URL	(empty)
slideshare	SlideShare	URL to your SlideShare profile.	Text (URL)	Valid URL	(empty)
skype	Skype	Your Skype username (used for `skype:` link).	Text	Skype username (text)	(empty)
envelope	Email Address	Your email address (used for `mailto:` link).	Text (Email)	Valid email address	(empty)
rss	RSS Feed	URL to your RSS feed.	Text (URL)	Valid URL	(empty)

Code Integration Notes

Widget class name: wp_masonry_social_widget
Widget ID: wp-masonry-social-profile-widget-id
Widget CSS class: wp-masonry-social-profile-widget
Widget registration hook: widgets_init
Text domain: wp-masonry-pro
Icons CSS classes: wp-masonry-social-[network] for links and fa fa-[network] for icons
Button style classes: wp-masonry-social-round-icons or wp-masonry-social-normal-icons

Widgets Areas

There are 23 widget areas in the WP Masonry PRO theme.

Header Banner

This sidebar is located on the header of the web page.
Main Sidebar

This sidebar is normally located on the left-hand side of web page.
Top Full Width Widgets (Home Page Only)

This full-width widget area is located at the top of homepage.
Top Full Width Widgets (Posts Only)

This full-width widget area is located at the top of single post.
Top Full Width Widgets (Posts/Pages Only)

This full-width widget area is located at the top of single post/page.
Top Full Width Widgets (Every Page)

This full-width widget area is located at the top of every page.
Bottom Full Width Widgets (Home Page Only)

This full-width widget area is located at the bottom of homepage.
Bottom Full Width Widgets (Posts Only)

This full-width widget area is located at the bottom of single post.
Bottom Full Width Widgets (Posts/Pages Only)

This full-width widget area is located at the bottom of single post/page.
Bottom Full Width Widgets (Every Page)

This full-width widget area is located at the bottom of every page.
Top Widgets (Home Page Only)

This widget area is located at the top of homepage.
Top Widgets (Posts Only)

This widget area is located at the top of single post.
Top Widgets (Posts/Pages Only)

This widget area is located at the top of single post/page.
Top Widgets (Every Page)

This widget area is located at the top of every page.
Bottom Widgets (Home Page Only)

This widget area is located at the bottom of homepage.
Bottom Widgets (Posts Only)

This widget area is located at the bottom of single post.
Bottom Widgets (Posts/Pages Only)

This widget area is located at the bottom of single post/page.
Bottom Widgets (Every Page)

This widget area is located at the bottom of every page.
Post Bottom Widgets

This widget area is located at the bottom of single post, before the comments.
Footer 1

This sidebar is located on the left bottom of web page.
Footer 2

This sidebar is located on the middle bottom of web page.
Footer 3

This sidebar is located on the middle bottom of web page.
Footer 4

This sidebar is located on the right bottom of web page.

How to Control Widget Visibility by Location

1. If you'd like to display a widget in specific locations only, please begin by installing and activating the Widget Display Conditions or Widget Context plugin.

2. Drag and drop your widget into any of the widget areas below:

Header Banner
Main Sidebar
Top Full Width Widgets (Every Page)
Bottom Full Width Widgets (Every Page)
Top Widgets (Every Page)
Bottom Widgets (Every Page)
Footer 1
Footer 2
Footer 3
Footer 4

3. If you are using Widget Display Conditions plugin, you will see a button called Display conditions at the bottom of your widget settings. Click on that button.

4. Now click on Add group button.

5. Set your widget display conditions and click save.

Custom Page Templates

WP Masonry PRO includes 11 custom templates in the theme folder: 7 for pages and 4 for posts. The page templates below help you control the page layout (sidebar position or full width) and create special pages like a contact page, an authors list, and a sitemap.

Full Width, no sidebar: A wide layout with no sidebar (great for landing pages).
Full Width, bottom sidebar: A wide layout with the sidebar shown below the content.
Content + Sidebar: A two-column layout (sidebar on the right on desktop).
Sidebar + Content: A two-column layout (sidebar on the left on desktop).
Contact Form: A page with a built-in contact form (no plugin required).
Authors: A page that automatically lists your website’s authors.
Sitemap: A page that automatically lists important parts of your site for easier navigation.

How to Assign a Custom Page Template:

Go to WordPress Dashboard → Pages → Add New (or edit an existing page).
Find the Template setting:
- In Gutenberg: Open the right sidebar → click the Page tab → find Template.
- In Classic Editor: Enable the Page Attributes box (Screen Options) → use the Template dropdown.
Select the template you want.
Click Publish or Update.

Full Width, no sidebar (Page Template)

Purpose

Use this template when you want your page content to span the full width of the site, without showing the sidebar.

Where to Find It

In WordPress: Edit a page → Template → Full Width, no sidebar.
Template file: template-full-width-page.php

Key Options

Comments: Enable/disable comments in the page Discussion settings (comments show only when enabled).
Widgets (optional): If you use the theme’s top/bottom widget areas, they can still appear above/below the page.

Notable Behaviors

The sidebar is not shown.
This affects only the pages where you choose this template.

Full Width, bottom sidebar (Page Template)

Purpose

Use this template when you want a wide page layout, but still want to show your sidebar content below the page.

Where to Find It

In WordPress: Edit a page → Template → Full Width, bottom sidebar.
Template file: template-full-width-page-sidebar.php

Key Options

Sidebar widgets: Go to Appearance → Widgets and add widgets to Main Sidebar.
Comments: Enable/disable comments in the page Discussion settings.

Notable Behaviors

The main content is full width; the sidebar appears underneath the content.
Works well when you want newsletter/signup widgets or ads after the page content.

Content + Sidebar (Page Template)

Purpose

Use this template for a classic two-column layout: page content plus a sidebar.

Where to Find It

In WordPress: Edit a page → Template → Content + Sidebar.
Template file: template-c-s1-page.php

Key Options

Sidebar widgets: Add widgets to Main Sidebar in Appearance → Widgets.
Comments: Enable/disable comments in the page Discussion settings.

Notable Behaviors

On desktop, the sidebar appears on the right and the content on the left.
On smaller screens, the sidebar will stack below the content.

Sidebar + Content (Page Template)

Purpose

Use this template when you want the sidebar to appear before the page content (helpful for navigation or category widgets).

Where to Find It

In WordPress: Edit a page → Template → Sidebar + Content.
Template file: template-s1-c-page.php

Key Options

Sidebar widgets: Add widgets to Main Sidebar in Appearance → Widgets.
Comments: Enable/disable comments in the page Discussion settings.

Notable Behaviors

On desktop, the sidebar appears on the left and the content on the right.
On smaller screens, the sidebar will stack below the content.

Contact Form (Page Template)

Purpose

Use this template to create a simple contact page with a built-in form. You can also add your own text (for example, an address or opening hours) above the form.

Where to Find It

In WordPress: Edit a page → Template → Contact Form.
Template file: template-contact-page.php

Key Options

Set the email address: Appearance → Customize → Theme Options → Contact Page → Contact Form Email Address.
Intro text: Add/edit page content in the editor (it shows above the form).

Note: If you don’t set the contact email address in the Customizer, the form will show an error and won’t send messages.

Notable Behaviors

The form asks for Name, Email, Subject, and Message.
A simple “math question” helps reduce spam.
This template does not show a comments section.

Authors (Page Template)

Purpose

Use this template to create an “Our Authors” / “Team” page that automatically lists authors on your website.

Where to Find It

In WordPress: Edit a page → Template → Authors.
Template file: template-site-authors.php

Key Options

Hide admins / hide authors with no posts: Appearance → Customize → Theme Options → Authors Page.
Author details: Each user can add their bio and social links in Users → Profile.

Notable Behaviors

The page editor content is not shown; the page is filled with the authors list automatically.
Typically shows each author’s name, avatar, bio, and social links (if provided).
This template does not show a comments section.

Sitemap (Page Template)

Purpose

Use this template to create a sitemap page that helps visitors quickly find content on your site.

Where to Find It

In WordPress: Edit a page → Template → Sitemap.
Template file: template-sitemap.php

Key Options

No special settings are required. The sitemap updates automatically as your site content changes.

Notable Behaviors

The page editor content is not shown; the page is filled with the sitemap blocks automatically.
Includes sections like Recent Posts, Recent Comments, Pages, Categories, Tags, Archives, and Authors.
This template does not show a comments section.

Custom Post Templates

WP Masonry PRO includes 4 custom post templates (part of the 11 custom templates included with the theme). Use them when you want certain posts to look different from your site’s default layout.

Full Width, no sidebar: A wide post layout with no sidebar.
Full Width, bottom sidebar: A wide post layout with the sidebar shown below the post.
Content + Sidebar: A two-column post layout (sidebar on the right on desktop).
Sidebar + Content: A two-column post layout (sidebar on the left on desktop).

How to Assign a Custom Post Template:

Go to WordPress Dashboard → Posts → Add New (or edit an existing post).
Find the Template setting:
- In Gutenberg: Open the right sidebar → click the Post tab → find Template.
- In Classic Editor: Look for a Template dropdown (sometimes inside a “Post Attributes” box). If you don’t see it, use Gutenberg for choosing templates.
Select the template you want.
Click Publish or Update.

Full Width, no sidebar (Post Template)

Purpose

Use this template when you want a clean, distraction-free reading experience for a post.

Where to Find It

In WordPress: Edit a post → Template → Full Width, no sidebar.
Template file: template-full-width-post.php

Key Options

Post Bottom Widgets: Add widgets to Post Bottom Widgets in Appearance → Widgets (shown before comments).
Comments: Enable/disable comments for the post (comments show only when enabled).

Notable Behaviors

The sidebar is not shown.
Includes next/previous post navigation.
Shows the Post Bottom Widgets area before the comments section.

Full Width, bottom sidebar (Post Template)

Purpose

Use this template when you want the post to be full width, but still want your sidebar widgets to appear underneath the post.

Where to Find It

In WordPress: Edit a post → Template → Full Width, bottom sidebar.
Template file: template-full-width-post-sidebar.php

Key Options

Sidebar widgets: Add widgets to Main Sidebar in Appearance → Widgets (shown below the post).
Post Bottom Widgets: Add widgets to Post Bottom Widgets (shown before comments).

Notable Behaviors

The main content is full width; the sidebar appears underneath the post.
Includes next/previous post navigation and the Post Bottom Widgets area.

Content + Sidebar (Post Template)

Purpose

Use this template for a classic two-column post layout: post content plus a sidebar.

Where to Find It

In WordPress: Edit a post → Template → Content + Sidebar.
Template file: template-c-s1-post.php

Key Options

Sidebar widgets: Add widgets to Main Sidebar in Appearance → Widgets.
Post Bottom Widgets: Add widgets to Post Bottom Widgets (shown before comments).

Notable Behaviors

On desktop, the sidebar appears on the right and the content on the left.
Includes next/previous post navigation.
On smaller screens, the sidebar will stack below the content.

Sidebar + Content (Post Template)

Purpose

Use this template when you want the sidebar to appear before the post content (useful for navigation or category widgets).

Where to Find It

In WordPress: Edit a post → Template → Sidebar + Content.
Template file: template-s1-c-post.php

Key Options

Sidebar widgets: Add widgets to Main Sidebar in Appearance → Widgets.
Post Bottom Widgets: Add widgets to Post Bottom Widgets (shown before comments).

Notable Behaviors

On desktop, the sidebar appears on the left and the content on the right.
Includes next/previous post navigation.
On smaller screens, the sidebar will stack below the content.

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.	Media Uploader	Integer (attachment ID)	0 (none)
blogname	Site Title	Main title of the website shown in the header, browser-tabs, and search-results.	Text	A string	“My WordPress Site” (installer-set)
blogdescription	Tagline	Short descriptive sentence (appears next to or below the title when supported by the theme).	Text	A string	“Just another WordPress site”
display_header_text	Display Site Title & Tagline	Toggles whether the title/tagline are printed on the front-end. When off they remain in the markup for accessibility but are hidden with CSS.	Checkbox	true / false	true
site_icon	Site Icon (Favicon)	Image ID for the favicon/app-icon (512 × 512 px recommended). Used in browser tabs, bookmark tiles and WP mobile app.	Media Uploader	Integer (attachment ID)	0 (none)

Colors Options

Below is the complete list of Colors Options available:

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 (e.g. #ffffff)	#555555
link_color	Main Link Color	Pick the Main Link Color.	Color Picker	Hex color code (e.g. #ffffff)	#666666
link_hover_color	Main Link Hover Color	Pick the Main Link Hover Color.	Color Picker	Hex color code (e.g. #ffffff)	#000000
headings_color	General Headings Color	Pick the General Headings Color.	Color Picker	Hex color code (e.g. #ffffff)	#111111
secondary_menu_color	Secondary Menu Link Color	Pick the Secondary Menu Link Color.	Color Picker	Hex color code (e.g. #ffffff)	#000000
secondary_menu_shadow_color	Secondary Menu Link Shadow Color	Pick the Secondary Menu Link Shadow Color.	Color Picker	Hex color code (e.g. #ffffff)	#ffffff
secondary_menu_hover_color	Secondary Menu Link Hover Color	Pick the Secondary Menu Link Hover Color.	Color Picker	Hex color code (e.g. #ffffff)	#e4002b
secondary_submenu_one_bg_color	Secondary Sub Menu Background Color	Pick the Secondary Sub Menu Background Color.	Color Picker	Hex color code (e.g. #ffffff)	#eeeeee
secondary_submenu_one_bd_color	Secondary Sub Menu Border Color	Pick the Secondary Sub Menu Border Color.	Color Picker	Hex color code (e.g. #ffffff)	#dddddd
secondary_menu_icon_color	Secondary Responsive Menu Icon Color	Pick the Secondary Responsive Menu Icon Color.	Color Picker	Hex color code (e.g. #ffffff)	#000000
header_bg_color	Header Background Color	Pick the Header Background Color.	Color Picker	Hex color code (e.g. #ffffff)	#ffffff
primary_menu_bg_color	Primary Menu Background Color	Pick the Primary Menu Background Color.	Color Picker	Hex color code (e.g. #ffffff)	#333333
primary_menu_color	Primary Menu Link Color	Pick the Primary Menu Link Color.	Color Picker	Hex color code (e.g. #ffffff)	#ffffff
primary_menu_shadow_color	Primary Menu Link Shadow Color	Pick the Primary Menu Link Shadow Color.	Color Picker	Hex color code (e.g. #ffffff)	#000000
primary_menu_hover_color	Primary Menu Link Hover Color	Pick the Primary Menu Link Hover Color.	Color Picker	Hex color code (e.g. #ffffff)	#ffffff
primary_menu_hover_bg_color	Primary Menu Link Hover Background Color	Pick the Primary Menu Link Hover Background Color.	Color Picker	Hex color code (e.g. #ffffff)	#b30703
primary_submenu_one_bg_color	Primary Sub Menu Background Color	Pick the Primary Sub Menu Background Color.	Color Picker	Hex color code (e.g. #ffffff)	#444444
primary_submenu_one_bd_color	Primary Sub Menu Border Color	Pick the Primary Sub Menu Border Color.	Color Picker	Hex color code (e.g. #ffffff)	#222222
primary_submenu_two_bd_color	Primary Sub Menu Border 2 Color	Pick the Primary Sub Menu Border 2 Color.	Color Picker	Hex color code (e.g. #ffffff)	#383838
primary_menu_icon_color	Primary Responsive Menu Icon Color	Pick the Primary Responsive Menu Icon Color.	Color Picker	Hex color code (e.g. #ffffff)	#ffffff
header_social_bg_color	Header Social Bar Background Color	Pick the Header Social Bar Background Color.	Color Picker	Hex color code (e.g. #ffffff)	#bbbbbb
news_ticker_bg_color	News Ticker Background Color	Pick the News Ticker Background Color.	Color Picker	Hex color code (e.g. #ffffff)	#6d6e70
news_ticker_heading_color	News Ticker Heading Color	Pick the News Ticker Heading Color.	Color Picker	Hex color code (e.g. #ffffff)	#ffffff
news_ticker_heading_bg_color	News Ticker Heading Background Color	Pick the News Ticker Heading Background Color.	Color Picker	Hex color code (e.g. #ffffff)	#333333
news_ticker_text_color	News Ticker Text Color	Pick the News Ticker Text Color.	Color Picker	Hex color code (e.g. #ffffff)	#ffffff
news_ticker_hover_text_color	News Ticker Hover Text Color	Pick the News Ticker Hover Text Color.	Color Picker	Hex color code (e.g. #ffffff)	#dddddd
sidebar_widget_bg_color	Sidebar Widgets Background Color	Pick the Sidebar Widgets Background Color.	Color Picker	Hex color code (e.g. #ffffff)	#ffffff
sidebar_widget_bd_color	Sidebar Widgets Border Color	Pick the Sidebar Widgets Border Color.	Color Picker	Hex color code (e.g. #ffffff)	#dddddd
grid_post_bg_color	Grid Post Background Color	Pick the Grid Post Background Color.	Color Picker	Hex color code (e.g. #ffffff)	#ffffff
grid_post_bd_color	Grid Post Border Color	Pick the Grid Post Border Color.	Color Picker	Hex color code (e.g. #ffffff)	#dddddd
post_title_color	Single Post Title Color	Pick the Single Post Title Color.	Color Picker	Hex color code (e.g. #ffffff)	#000000
post_title_hover_color	Single Post Title Hover Color	Pick the Single Post Title Hover Color.	Color Picker	Hex color code (e.g. #ffffff)	#333333
list_post_title_color	List Post Title Color	Pick the List Post Title Color.	Color Picker	Hex color code (e.g. #ffffff)	#000000
list_post_title_hover_color	List Post Title Hover Color	Pick the List Post Title Hover Color.	Color Picker	Hex color code (e.g. #ffffff)	#333333
grid_post_title_color	Grid Post Title Color	Pick the Grid Post Title Color.	Color Picker	Hex color code (e.g. #ffffff)	#000000
grid_post_title_hover_color	Grid Post Title Hover Color	Pick the Grid Post Title Hover Color.	Color Picker	Hex color code (e.g. #ffffff)	#b52e31
post_body_link_color	Post Content Link Color	Pick the Post Content Link Color.	Color Picker	Hex color code (e.g. #ffffff)	#409BD4
post_body_link_hover_color	Post Content Link Hover Color	Pick the Post Content Link Hover Color.	Color Picker	Hex color code (e.g. #ffffff)	#08ACD5
postcats_color	Post Categories Color	Pick the Post Categories Color.	Color Picker	Hex color code (e.g. #ffffff)	#ffffff
postcats_bg_color	Post Categories Background Color	Pick the Post Categories Background Color.	Color Picker	Hex color code (e.g. #ffffff)	#d29e57
postcats_hover_color	Post Categories Hover Color	Pick the Post Categories Hover Color.	Color Picker	Hex color code (e.g. #ffffff)	#ffffff
postcats_bg_hover_color	Post Categories Hover Background Color	Pick the Post Categories Hover Background Color.	Color Picker	Hex color code (e.g. #ffffff)	#000000
post_meta_color	Single Post Meta Color	Pick the Single Post Meta Color.	Color Picker	Hex color code (e.g. #ffffff)	#666666
post_meta_hover_color	Single Post Meta Hover Color	Pick the Single Post Meta Hover Color.	Color Picker	Hex color code (e.g. #ffffff)	#000000
list_post_meta_color	List Post Meta Color	Pick the List Post Meta Color.	Color Picker	Hex color code (e.g. #ffffff)	#666666
list_post_meta_hover_color	List Post Meta Hover Color	Pick the List Post Meta Hover Color.	Color Picker	Hex color code (e.g. #ffffff)	#000000
grid_post_meta_color	Grid Post Meta Color	Pick the Grid Post Meta Color.	Color Picker	Hex color code (e.g. #ffffff)	#ffffff
grid_post_meta_hover_color	Grid Post Meta Hover Color	Pick the Grid Post Meta Hover Color.	Color Picker	Hex color code (e.g. #ffffff)	#ffffff
sidebar_title_color	Sidebar Title Color	Pick the Sidebar Title Color.	Color Picker	Hex color code (e.g. #ffffff)	#ffffff
sidebar_title_bg_color	Sidebar Title Background Color	Pick the Sidebar Title Background Color.	Color Picker	Hex color code (e.g. #ffffff)	#333333
sidebar_title_bd_one_color	Sidebar Title Border 1 Color	Pick the Sidebar Title Border 1 Color.	Color Picker	Hex color code (e.g. #ffffff)	#222222
sidebar_title_bd_two_color	Sidebar Title Border 2 Color	Pick the Sidebar Title Border 2 Color.	Color Picker	Hex color code (e.g. #ffffff)	#555555
sidebar_link_color	Sidebar Link Color	Pick the Sidebar Link Color.	Color Picker	Hex color code (e.g. #ffffff)	#444444
sidebar_link_hover_color	Sidebar Link Hover Color	Pick the Sidebar Link Hover Color.	Color Picker	Hex color code (e.g. #ffffff)	#666666
sidebar_list_bd_color	Sidebar List Border Color	Pick the Sidebar List Border Color.	Color Picker	Hex color code (e.g. #ffffff)	#f6f6f6
tag_cloud_color	Tag Cloud Link Color	Pick the Tag Cloud Link Color.	Color Picker	Hex color code (e.g. #ffffff)	#ffffff
tag_cloud_bg_color	Tag Cloud Link Background	Pick the tag Cloud Link Background color.	Color Picker	Hex color code (e.g. #ffffff)	#888888
tag_cloud_hover_color	Tag Cloud Link Hover Color	Pick the Tag Cloud Link Hover Color.	Color Picker	Hex color code (e.g. #ffffff)	#ffffff
tag_cloud_hover_bg_color	Tag Cloud Link Hover Background	Pick the tag Cloud Link Hover Background color.	Color Picker	Hex color code (e.g. #ffffff)	#000000
footer_bg_color	Footer Background Color	Pick the Footer Background Color.	Color Picker	Hex color code (e.g. #ffffff)	#333333
footer_bd_color	Footer Border Color	Pick the Footer Border Color.	Color Picker	Hex color code (e.g. #ffffff)	#333333
footer_title_color	Footer Title Color	Pick the Footer Title Color.	Color Picker	Hex color code (e.g. #ffffff)	#ffffff
footer_title_bd_one_color	Footer Title Border One Color	Pick the Footer Title Border One Color.	Color Picker	Hex color code (e.g. #ffffff)	#444444
footer_title_bd_two_color	Footer Title Border Two Color	Pick the Footer Title Border Two Color.	Color Picker	Hex color code (e.g. #ffffff)	#222222
footer_text_color	Footer Text Color	Pick the Footer Text Color.	Color Picker	Hex color code (e.g. #ffffff)	#cecece
footer_link_color	Footer Link Color	Pick the Footer Link Color.	Color Picker	Hex color code (e.g. #ffffff)	#dbdbdb
footer_link_hover_color	Footer Link Hover Color	Pick the Footer Link Hover Color.	Color Picker	Hex color code (e.g. #ffffff)	#ffffff
footer_list_bd_color	Footer List Border Color	Pick the Footer List Border Color.	Color Picker	Hex color code (e.g. #ffffff)	#3a3a3a
cp_bg_color	Copyrights Background Color	Pick the Copyrights Background Color.	Color Picker	Hex color code (e.g. #ffffff)	#222222
cp_bd_color	Copyrights Background Color	Pick the Copyrights Background Color.	Color Picker	Hex color code (e.g. #ffffff)	#3D3D3D
cp_color	Copyrights Text Color	Pick the Copyrights Text Color.	Color Picker	Hex color code (e.g. #ffffff)	#ECFFF1
button_text_color	Button Text Color	Pick the Button Text Color.	Color Picker	Hex color code (e.g. #ffffff)	#ffffff
button_text_shadow_color	Button Text Shadow Color	Pick the Button Text Shadow Color.	Color Picker	Hex color code (e.g. #ffffff)	#000000
button_bg_color	Button Background Color	Pick the Button Background Color.	Color Picker	Hex color code (e.g. #ffffff)	#333333
button_bd_color	Button Border Color	Pick the Button Border Color.	Color Picker	Hex color code (e.g. #ffffff)	#000000
button_hover_bg_color	Button Hover Background Color	Pick the Button Hover Background Color.	Color Picker	Hex color code (e.g. #ffffff)	#000000
selected_text_color	Selected Text Color	Pick the Selected Text Color.	Color Picker	Hex color code (e.g. #ffffff)	#ffffff
selected_text_bg_color	Selected Text Background Color	Pick the Selected Text Background Color.	Color Picker	Hex color code (e.g. #ffffff)	#333333
disable_shadow_color	Disable Shadow Color	Disable Shadow Color	Checkbox	true / false	false

Font Options

Below is the complete list of Font Options available:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
font_subsets	Font Subsets	Select which font subsets should be supported.	Tdna-Multiple-Select	Mixed (depends on setting)	(empty)
body_fonts	Body Font-Family	Pick a font for body text. Default is Domine.	Dropdown	A font name selected from the available font name list.	Domine
body_font_size	Body Font-Size	Choose body font size. Default is 13px.	Dropdown	A font size value (in px) selected from the available font size list.	13px
body_font_weight	Body Font-Weight	Choose body font weight. Default is 400.	Dropdown	400 700	400
body_font_style	Body Font-Style	Choose body font style. Default is normal.	Dropdown	Normal Italic	Normal
body_line_height	Body Line-Height	Enter body line height. Default is 1.6.	Text Input	Text string	1.6
site_title_fonts	Site Title Font-Family	Pick a font for site title. Default is Playfair Display.	Dropdown	A font name selected from the available font name list.	Playfair Display
site_title_font_size	Site Title Font-Size	Choose site title font size. Default is 24px.	Dropdown	A font size value (in px) selected from the available font size list.	24px
site_title_font_weight	Site Title Font-Weight	Choose site title font weight. Default is 700.	Dropdown	400 700	700
site_title_font_style	Site Title Font-Style	Choose site title font style. Default is normal.	Dropdown	Normal Italic	Normal
site_title_line_height	Site Title Line-Height	Enter site title line height. Default is 1.	Text Input	Text string	1
site_desc_fonts	Site Description Font-Family	Pick a font for site description. Default is Domine.	Dropdown	A font name selected from the available font name list.	Domine
site_desc_font_size	Site Description Font-Size	Choose site description font size. Default is 13px.	Dropdown	A font size value (in px) selected from the available font size list.	13px
site_desc_font_weight	Site Description Font-Weight	Choose site description font weight. Default is 400.	Dropdown	400 700	400
site_desc_font_style	Site Description Font-Style	Choose site description font style. Default is normal.	Dropdown	Normal Italic	Normal
site_desc_line_height	Site Description Line-Height	Enter site description line height. Default is 1.	Text Input	Text string	1
primary_menu_fonts	Primary Menu Font-Family	Pick a font for the primary menu. Default is Oswald.	Dropdown	A font name selected from the available font name list.	Oswald
primary_menu_font_size	Primary Menu Font-Size	Choose primary menu font size. Default is 13px.	Dropdown	A font size value (in px) selected from the available font size list.	13px
primary_menu_font_weight	Primary Menu Font-Weight	Choose primary menu font weight. Default is 400.	Dropdown	400 700	400
primary_menu_font_style	Primary Menu Font-Style	Choose primary menu font style. Default is normal.	Dropdown	Normal Italic	Normal
secondary_menu_fonts	Secondary Menu Font-Family	Pick a font for the secondary menu. Default is Oswald.	Dropdown	A font name selected from the available font name list.	Oswald
secondary_menu_font_size	Secondary Menu Font-Size	Choose secondary menu font size. Default is 13px.	Dropdown	A font size value (in px) selected from the available font size list.	13px
secondary_menu_font_weight	Secondary Menu Font-Weight	Choose secondary menu font weight. Default is 400.	Dropdown	400 700	400
secondary_menu_font_style	Secondary Menu Font-Style	Choose secondary menu font style. Default is normal.	Dropdown	Normal Italic	Normal
news_ticker_fonts	News Ticker Font-Family	Pick a font for the news ticker. Default is Oswald.	Dropdown	A font name selected from the available font name list.	Oswald
news_ticker_font_size	News Ticker Font-Size	Choose news ticker font size. Default is 13px.	Dropdown	A font size value (in px) selected from the available font size list.	13px
news_ticker_font_weight	News Ticker Font-Weight	Choose news ticker font weight. Default is 400.	Dropdown	400 700	400
news_ticker_font_style	News Ticker Font-Style	Choose news ticker font style. Default is normal.	Dropdown	Normal Italic	Normal
hpost_title_fonts	Grid Post Title Font-Family	Pick a font for grid post titles. Default is Playfair Display.	Dropdown	A font name selected from the available font name list.	Playfair Display
hpost_title_font_size	Grid Post Title Font-Size	Choose grid post title font size. Default is 17px.	Dropdown	A font size value (in px) selected from the available font size list.	17px
hpost_title_font_weight	Grid Post Title Font-Weight	Choose grid post title font weight. Default is 700.	Dropdown	400 700	700
hpost_title_font_style	Grid Post Title Font-Style	Choose grid post title font style. Default is normal.	Dropdown	Normal Italic	Normal
hpost_title_line_height	Grid Post Title Line-Height	Enter grid post title line height. Default is 1.2.	Text Input	Text string	1.2
hpost_title_sm_fonts	List Post Title Font-Family	Pick a font for list post titles. Default is Playfair Display.	Dropdown	A font name selected from the available font name list.	Playfair Display
hpost_title_sm_font_size	List Post Title Font-Size	Choose list post title font size. Default is 16px.	Dropdown	A font size value (in px) selected from the available font size list.	16px
hpost_title_sm_font_weight	List Post Title Font-Weight	Choose list post title font weight. Default is 700.	Dropdown	400 700	700
hpost_title_sm_font_style	List Post Title Font-Style	Choose list post title font style. Default is normal.	Dropdown	Normal Italic	Normal
hpost_title_sm_line_height	List Post Title Line-Height	Enter list post title line height. Default is 1.2.	Text Input	Text string	1.2
hpost_cats_fonts	Grid Post Categories Font-Family	Pick a font for grid post categories. Default is Oswald.	Dropdown	A font name selected from the available font name list.	Oswald
hpost_cats_font_size	Grid Post Categories Font-Size	Choose grid post categories font size. Default is 12px.	Dropdown	A font size value (in px) selected from the available font size list.	12px
hpost_cats_font_weight	Grid Post Categories Font-Weight	Choose grid post categories font weight. Default is 400.	Dropdown	400 700	400
hpost_cats_font_style	Grid Post Categories Font-Style	Choose grid post categories font style. Default is normal.	Dropdown	Normal Italic	Normal
hpost_meta_fonts	Post Meta Font-Family	Pick a font for post meta. Default is Oswald.	Dropdown	A font name selected from the available font name list.	Oswald
hpost_meta_font_size	Post Meta Font-Size	Choose post meta font size. Default is 12px.	Dropdown	A font size value (in px) selected from the available font size list.	12px
hpost_meta_font_weight	Post Meta Font-Weight	Choose post meta font weight. Default is 400.	Dropdown	400 700	400
hpost_meta_font_style	Post Meta Font-Style	Choose post meta font style. Default is normal.	Dropdown	Normal Italic	Normal
post_title_fonts	Post Title Font-Family	Pick a font for post titles. Default is Playfair Display.	Dropdown	A font name selected from the available font name list.	Playfair Display
post_title_font_size	Post Title Font-Size	Choose post title font size. Default is 26px.	Dropdown	A font size value (in px) selected from the available font size list.	26px
post_title_font_weight	Post Title Font-Weight	Choose post title font weight. Default is 700.	Dropdown	400 700	700
post_title_font_style	Post Title Font-Style	Choose post title font style. Default is normal.	Dropdown	Normal Italic	Normal
post_title_line_height	Post Title Line-Height	Enter post title line height. Default is 1.2.	Text Input	Text string	1.2
widget_title_fonts	Main/Sidebars Widget Title Font-Family	Pick a font for sidebar widget titles. Default is Oswald.	Dropdown	A font name selected from the available font name list.	Oswald
widget_title_font_size	Main/Sidebars Title Font-Size	Choose main/sidebar title font size. Default is 15px.	Dropdown	A font size value (in px) selected from the available font size list.	15px
widget_title_font_weight	Main/Sidebars Title Font-Weight	Choose main/sidebar title font weight. Default is 400.	Dropdown	400 700	400
widget_title_font_style	Main/Sidebars Title Font-Style	Choose main/sidebar title font style. Default is normal.	Dropdown	Normal Italic	Normal
sidebar_title_line_height	Main/Sidebars Title Line-Height	Enter main/sidebar title line height. Default is 1.	Text Input	Text string	1
footer_title_fonts	Footer Widget Title Font-Family	Pick a font for footer widget titles. Default is Oswald.	Dropdown	A font name selected from the available font name list.	Oswald
footer_title_font_size	Footer Title Font-Size	Choose footer title font size. Default is 14px.	Dropdown	A font size value (in px) selected from the available font size list.	14px
footer_title_font_weight	Footer Title Font-Weight	Choose footer title font weight. Default is 400.	Dropdown	400 700	400
footer_title_font_style	Footer Title Font-Style	Choose footer title font style. Default is normal.	Dropdown	Normal Italic	Normal
footer_title_line_height	Footer Title Line-Height	Enter footer title line height. Default is 1.	Text Input	Text string	1
headings_fonts	General Headings Font-Family	Pick a font for general headings. Default is Playfair Display.	Dropdown	A font name selected from the available font name list.	Playfair Display
headings_line_height	General Headings Line-Height	Enter general headings line height. Default is 1.	Text Input	Text string	1
h1_font_size	H1 Font-Size	Choose H1 font size. Default is 32px.	Dropdown	A font size value (in px) selected from the available font size list.	32px
h1_font_weight	H1 Font-Weight	Choose H1 font weight. Default is 700.	Dropdown	400 700	700
h1_font_style	H1 Font-Style	Choose H1 font style. Default is normal.	Dropdown	Normal Italic	Normal
h2_font_size	H2 Font-Size	Choose H2 font size. Default is 28px.	Dropdown	A font size value (in px) selected from the available font size list.	28px
h2_font_weight	H2 Font-Weight	Choose H2 font weight. Default is 700.	Dropdown	400 700	700
h2_font_style	H2 Font-Style	Choose H2 font style. Default is normal.	Dropdown	Normal Italic	Normal
h3_font_size	H3 Font-Size	Choose H3 font size. Default is 24px.	Dropdown	A font size value (in px) selected from the available font size list.	24px
h3_font_weight	H3 Font-Weight	Choose H3 font weight. Default is 700.	Dropdown	400 700	700
h3_font_style	H3 Font-Style	Choose H3 font style. Default is normal.	Dropdown	Normal Italic	Normal
h4_font_size	H4 Font-Size	Choose H4 font size. Default is 20px.	Dropdown	A font size value (in px) selected from the available font size list.	20px
h4_font_weight	H4 Font-Weight	Choose H4 font weight. Default is 700.	Dropdown	400 700	700
h4_font_style	H4 Font-Style	Choose H4 font style. Default is normal.	Dropdown	Normal Italic	Normal
h5_font_size	H5 Font-Size	Choose H5 font size. Default is 18px.	Dropdown	A font size value (in px) selected from the available font size list.	18px
h5_font_weight	H5 Font-Weight	Choose H5 font weight. Default is 700.	Dropdown	400 700	700
h5_font_style	H5 Font-Style	Choose H5 font style. Default is normal.	Dropdown	Normal Italic	Normal
h6_font_size	H6 Font-Size	Choose H6 font size. Default is 16px.	Dropdown	A font size value (in px) selected from the available font size list.	16px
h6_font_weight	H6 Font-Weight	Choose H6 font weight. Default is 700.	Dropdown	400 700	700
h6_font_style	H6 Font-Style	Choose H6 font style. Default is normal.	Dropdown	Normal Italic	Normal

Header Options

Below is the complete list of Header Options available:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
hide_social_bar	Hide Header Social Bar	Turn on or off hide Header Social Bar.	Checkbox	true / false	false
site_header_style	Header Style	Select site header style.	Radio Buttons	Logo (left-side) + Menu (right-side) Logo (full-width) + Menu (full-width) Logo (left-side) + Banner (right-side) Logo (full-width) + Banner (full-width) Logo (full-width)	Logo (full-width)
hide_header_content	Hide Header Content	Turn on or off hide Header Content.	Checkbox	true / false	false
disable_featured_header	Disable Featured Header Image	Disable Featured Header Image	Checkbox	true / false	false

Layout Options

Below is the complete list of Layout Options available:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
non_singular_layout	Non-Singular Layout Style	Select your layout style for non-singular pages.	Radio Buttons	Sidebar + Content Content + Sidebar One Column	One Column
singular_layout	Singular Layout Style	Select your layout style for singular posts/pages.	Radio Buttons	Sidebar + Content Content + Sidebar One Column	Content + Sidebar
show_sidebar_one_column	Show Sidebar on One Column Layout	Turn on or off show Sidebar on One Column Layout.	Checkbox	true / false	false

News Ticker Options

Below is the complete list of News Ticker Options available:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
enable_news_ticker	Enable News Ticker	Enable News Ticker	Checkbox	true / false	false
news_ticker_heading	News Ticker Heading	Set the news Ticker Heading.	Text Input	Text string	(empty)
news_ticker_length	Number of News Ticker Posts	Enter the number of posts you need to display in the news ticker area. Default is 5 posts.	Number Input	Integer	5
news_ticker_post_type	News Ticker Posts Type	Select a post type to display in news ticker.	Dropdown	Recent Posts Popular Posts Random Posts Category Posts Tag Posts	Recent Posts
news_ticker_cat	News Ticker Posts Category	Select a category if Posts Type option is Category Posts	Number Input	Integer	0
news_ticker_tag	News Ticker Posts Tag	Select a tag if Posts Type option is Tag Posts	Number Input	Integer	0

Post Options

Below is the complete list of Post Options available:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
hide_posts_heading	Hide HomePage Posts Heading	Turn on or off hide HomePage Posts Heading.	Checkbox	true / false	false
posts_heading	HomePage Posts Heading	Set the homePage Posts Heading.	Text Input	Text string	(empty)
thumbnail_link	Thumbnail Link	Do you want single post thumbnail to be linked to their post?	Dropdown	Yes No	Yes
grid_thumb_style	Posts Grid Thumbnails Style	Select the thumbnail style you need for the post grid.	Dropdown	Horizontal Thumbnails Square Thumbnails Vertical Thumbnails Auto Height Thumbnails	Auto Height Thumbnails
post_grid_cols	Posts Grid Columns	Select the number of columns in the post grid in desktop view.	Dropdown	2 Columns 3 Columns 4 Columns 5 Columns	4 Columns
read_more_length	Auto Post Summary Length	Enter the number of words need to display in the post summary. Default is 20 words.	Number Input	Integer	20
show_post_snippet	Show Post Snippet	Turn on or off show Post Snippet.	Checkbox	true / false	false
hide_posted_date_home	Hide Posted Date from Posts Summaries	Turn on or off hide Posted Date from Posts Summaries.	Checkbox	true / false	false
hide_posted_date	Hide Posted Date from Single Posts	Turn on or off hide Posted Date from Single Posts.	Checkbox	true / false	false
hide_post_author_home	Hide Post Author from Posts Summaries	Turn on or off hide Post Author from Posts Summaries.	Checkbox	true / false	false
hide_post_author	Hide Post Author from Single Posts	Turn on or off hide Post Author from Single Posts.	Checkbox	true / false	false
hide_post_categories_home	Hide Post Categories from Posts Summaries	Turn on or off hide Post Categories from Posts Summaries.	Checkbox	true / false	false
hide_post_categories	Hide Post Categories from Single Posts	Turn on or off hide Post Categories from Single Posts.	Checkbox	true / false	false
hide_post_tags_home	Hide Post Tags from Posts Summaries	Turn on or off hide Post Tags from Posts Summaries.	Checkbox	true / false	false
hide_post_tags	Hide Post Tags from Single Posts	Turn on or off hide Post Tags from Single Posts.	Checkbox	true / false	false
hide_comments_link_home	Hide Comment Link from Posts Summaries	Turn on or off hide Comment Link from Posts Summaries.	Checkbox	true / false	false
hide_comments_link	Hide Comment Link from Single Posts	Turn on or off hide Comment Link from Single Posts.	Checkbox	true / false	false
hide_post_edit	Hide Post Edit Link	Turn on or off hide Post Edit Link.	Checkbox	true / false	false
hide_thumbnail	Hide Thumbnails from Every Page	Turn on or off hide Thumbnails from Every Page.	Checkbox	true / false	false
hide_thumbnail_single	Hide Thumbnails from Posts/Pages	Turn on or off hide Thumbnails from Posts/Pages.	Checkbox	true / false	false
hide_share_buttons_home	Hide Share Buttons from Posts Summaries	Turn on or off hide Share Buttons from Posts Summaries.	Checkbox	true / false	false
hide_share_buttons	Hide Share Buttons from Single Posts	Turn on or off hide Share Buttons from Single Posts.	Checkbox	true / false	false
hide_author_bio_box	Hide Author Bio Box	Turn on or off hide Author Bio Box.	Checkbox	true / false	false
hide_related_posts	Hide Related Posts from Single Posts	Turn on or off hide Related Posts from Single Posts.	Checkbox	true / false	false
related_posts_heading	Related Posts Heading	Set the related Posts Heading.	Text Input	Text string	(empty)
related_posts_number	Number of Related Posts	Choose the number of posts you need to display in the related posts area	Dropdown	Mixed (depends on setting)	4
related_grid_cols	Related Posts Columns	Select the number of columns in the related posts in desktop view.	Dropdown	2 Columns 3 Columns 4 Columns 5 Columns	4 Columns
show_rpost_snippet	Show Related Post Snippet	Turn on or off show Related Post Snippet.	Checkbox	true / false	false

Social Links Options

Below is the complete list of Social Links Options available:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
hide_header_social_buttons	Hide Header Social Buttons	Turn on or off hide Header Social Buttons.	Checkbox	true / false	false
twitterlink	Twitter URL	Enter the twitter URL.	URL Input	Valid URL	(empty)
facebooklink	Facebook URL	Enter the facebook URL.	URL Input	Valid URL	(empty)
googlelink	Google Plus URL	Enter the google Plus URL.	URL Input	Valid URL	(empty)
pinterestlink	Pinterest URL	Enter the pinterest URL.	URL Input	Valid URL	(empty)
linkedinlink	Linkedin Link	Enter the linkedin Link.	URL Input	Valid URL	(empty)
instagramlink	Instagram Link	Enter the instagram Link.	URL Input	Valid URL	(empty)
vklink	VK Link	Enter the vK Link.	URL Input	Valid URL	(empty)
flickrlink	Flickr Link	Enter the flickr Link.	URL Input	Valid URL	(empty)
youtubelink	Youtube URL	Enter the youtube URL.	URL Input	Valid URL	(empty)
vimeolink	Vimeo URL	Enter the vimeo URL.	URL Input	Valid URL	(empty)
soundcloudlink	Soundcloud URL	Enter the soundcloud URL.	URL Input	Valid URL	(empty)
lastfmlink	Lastfm URL	Enter the lastfm URL.	URL Input	Valid URL	(empty)
githublink	Github URL	Enter the github URL.	URL Input	Valid URL	(empty)
bitbucketlink	Bitbucket URL	Enter the bitbucket URL.	URL Input	Valid URL	(empty)
tumblrlink	Tumblr URL	Enter the tumblr URL.	URL Input	Valid URL	(empty)
digglink	Digg URL	Enter the digg URL.	URL Input	Valid URL	(empty)
deliciouslink	Delicious URL	Enter the delicious URL.	URL Input	Valid URL	(empty)
stumblelink	Stumbleupon Link	Enter the stumbleupon Link.	URL Input	Valid URL	(empty)
redditlink	Reddit Link	Enter the reddit Link.	URL Input	Valid URL	(empty)
dribbblelink	Dribbble Link	Enter the dribbble Link.	URL Input	Valid URL	(empty)
behancelink	Behance Link	Enter the behance Link.	URL Input	Valid URL	(empty)
codepenlink	Codepen Link	Enter the codepen Link.	URL Input	Valid URL	(empty)
jsfiddlelink	JSFiddle Link	Enter the jSFiddle Link.	URL Input	Valid URL	(empty)
stackoverflowlink	Stack Overflow Link	Enter the stack Overflow Link.	URL Input	Valid URL	(empty)
stackexchangelink	Stack Exchange Link	Enter the stack Exchange Link.	URL Input	Valid URL	(empty)
bsalink	BuySellAds Link	Enter the buySellAds Link.	URL Input	Valid URL	(empty)
slidesharelink	SlideShare Link	Enter the slideShare Link.	URL Input	Valid URL	(empty)
skypeusername	Skype Username	Set the skype Username.	Text Input	Text string	(empty)
emailaddress	Email Address	Enter the email Address.	Email Input	Valid email address	(empty)
telephonenumber	Telephone Number	Set the telephone Number.	Text Input	Text string	(empty)
rsslink	RSS Feed URL	Enter the rSS Feed URL.	URL Input	Valid URL	(empty)

Footer Options

Below is the complete list of Footer Options available:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
footer_text	Footer copyright notice	Set the footer copyright notice.	Text Input	Text string	(empty)
hide_footer_widgets	Hide Footer Widgets	Turn on or off hide Footer Widgets.	Checkbox	true / false	false
hide_credit	Hide Theme Designer Credits	Turn on or off hide Theme Designer Credits.	Checkbox	true / false	false

Authors Page Options

Below is the complete list of Authors Page Options available:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
authors_page_text	Authors Page Configuration	Follow these steps to create a authors page:	Text Input	Text string	(empty)
hide_admin_authors_page	Hide site administrators from Authors page	Turn on or off hide site administrators from Authors page.	Checkbox	true / false	false
hide_noposts_authors_page	Hide authors with zero posts from Authors page	Turn on or off hide authors with zero posts from Authors page.	Checkbox	true / false	false

Contact Page Options

Below is the complete list of Contact Page Options available:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
contact_page_text	Contact Page Configuration	Follow these steps to create a contact page with a built-in contact form:	Text Input	Text string	(empty)
contact_form_email	Contact Form Email Address	When a user contacts you using the built-in contact form of the theme, this is your email address to get these messages.	Email Input	Valid email address	(empty)

Search Page Options

Below is the complete list of Search Page Options available:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
no_search_heading	No Search Results Heading	Enter a heading to display when no search results are found.	Textarea	Multiline text	(empty)
no_search_results	No Search Results Message	Enter a message to display when no search results are found.	Textarea	Multiline text	(empty)

404 Page Options

Below is the complete list of 404 Page Options available:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
error_404_heading	404 Error Page Heading	Enter the heading for the 404 error page.	Textarea	Multiline text	(empty)
error_404_message	Error 404 Message	Enter a message to display on the 404 error page.	Textarea	Multiline text	(empty)

Other Options

Below is the complete list of Other Options available:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
enable_widgets_block_editor	Enable Gutenberg Widget Block Editor	Enable Gutenberg Widget Block Editor	Checkbox	true / false	false
disable_sticky_menu	Disable Sticky Menu	Disable Sticky Menu	Checkbox	true / false	false
enable_sticky_mobile_menu	Enable Sticky Menu on Small Screen	Enable Sticky Menu on Small Screen	Checkbox	true / false	false
disable_primary_menu	Disable Primary Menu	Disable Primary Menu	Checkbox	true / false	false
disable_secondary_menu	Disable Secondary Menu	Disable Secondary Menu	Checkbox	true / false	false
disable_sticky_sidebar	Disable Sticky Sidebar	Disable Sticky Sidebar	Checkbox	true / false	false
disable_backtotop	Disable Back to Top Button	Disable Back to Top Button	Checkbox	true / false	false

Reset Settings Options

Below is the complete list of Reset Settings Options available:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
reset_settings	Reset all theme options made for this theme to their default values by clicking the button below.	Set the reset all theme options made for this theme to their default values by clicking the button below..	Wp-Masonry-Reset-Button	Mixed (depends on setting)	(empty)

Performance & SEO Tips

To get the best out of WP Masonry PRO, it's important to optimize your website for both performance and search engines. Below are helpful tips to improve loading speed, user experience, and your site's visibility on search engines and social media:

Use Optimized & WebP Images: Compress images using tools like TinyPNG and convert them to WebP format for better performance and smaller file sizes.
Enable Caching: Use a caching plugin like WP Super Cache or WP Rocket to reduce load times.
Use a CDN: Content Delivery Networks like Cloudflare or BunnyCDN help deliver your website content faster across the globe.
Minify CSS & JavaScript: Use a plugin like Autoptimize to reduce file sizes and improve performance.
Optimize Fonts: Load Google Fonts asynchronously or host them locally to prevent render-blocking. Or use system fonts for maximum speed.
Avoid Unnecessary Plugins: Even though WP Masonry PRO is performance-optimized, using too many plugins can slow down your site. Only install plugins that are essential for your functionality.
Set SEO Titles & Meta Descriptions: Use plugins like Yoast SEO or Rank Math to improve on-page SEO and indexability.
Display Correct Thumbnails on Social Media: To ensure your post thumbnails appear properly when sharing on Facebook, X (Twitter), or LinkedIn, install an SEO plugin and enable Open Graph and Twitter Card meta tags. Set a featured image for each post.
Enable Lazy Loading: Use WordPress’s built-in lazy loading or plugins like a3 Lazy Load to delay off-screen images and speed up initial page load.
Clean the Database: Use plugins like WP-Optimize to remove post revisions, spam comments, and transients.
Add Structured Data: Enhance search visibility with schema markup using Rank Math or Yoast's advanced schema tools.

Translation & RTL

WP Masonry 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 wp-masonry-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:

wp-masonry-pro-[language_code].po
wp-masonry-pro-[language_code].mo

Place them inside the /languages folder in the theme.

↔️ RTL Language Support

WP Masonry 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 WP Masonry PRO theme. These cover common scenarios and settings that often confuse new users. 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 correct theme locations.

How to activate the "Load More" navigation for posts?

Go to Appearance → Customize → Theme Options → Post/Posts Navigation Options.
Under the Posts Navigation Type setting, select Load More Button.
Save your changes, and load more button navigation will be enabled for your post listings.

Note: Also you need to deactivated the "WP-PageNavi plugin" if you are using it.

How to activate the "Infinite Scroll" navigation for posts?

Go to Appearance → Customize → Theme Options → Post/Posts Navigation Options.
Under the Posts Navigation Type setting, select Infinite Scroll.
Save your changes, and infinite scrolling will be enabled for your post listings.

Note: Also you need to deactivated the "WP-PageNavi plugin" if you are using it.

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.

Troubleshooting

This section covers common technical problems you may encounter while installing, activating, or customizing the WP Masonry PRO theme. Each issue includes practical steps you can follow to quickly resolve the problem and get your site running smoothly. 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.

Support & Licensing

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

= Version 1.0.6 =

Fixed coding issues

= Version 1.0.5 =

Fixed coding issues
Many improvements

= Version 1.0.4 =

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

Introduction

Theme Installation

Upgrading from the Free WP Masonry 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 Site-wide Header Image?

How to Add a Header Image to a Post?

How to Add a Header Image to a Page?

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

Add a Custom Title/Description to Site-wide Header Image:

How to Add a Custom Title/Description to the Header Image of a Post?

How to Add a Custom Title and Description to the Header Image of a Page?

How to Hide Title/Description from Header Image?

How to Change Linked URL of Header Image?

Change Linked URL of Site-wide Header Image:

Change Linked URL of the Header Image of a Post:

Change Linked URL of the Header Image of a Page:

Navigation Menus

News Ticker

How to Configure the News Ticker

Step 1: Access the News Ticker Options

Step 2: Enable the News Ticker

Step 3: Configure Ticker Options

Step 4: Save Changes

Tips

Custom Widgets

Quick Start Guide

WP Masonry Featured Posts Widget - Style 1

Key Features

Usage Notes

WP Masonry Featured Posts Widget - Style 2

Key Features

Usage Notes

WP Masonry Tabbed Widget

Key Features

Usage Notes

Tab Content Details

Common Parameters Applied to All Tabs

WP Masonry About Widget

Key Features

Usage Notes

WP Masonry Social Buttons Widget

Key Features

Usage Notes

Code Integration Notes

Widgets Areas

Header Banner

Main Sidebar

Top Full Width Widgets (Home Page Only)

Top Full Width Widgets (Posts Only)

Top Full Width Widgets (Posts/Pages Only)

Top Full Width Widgets (Every Page)

Bottom Full Width Widgets (Home Page Only)

Bottom Full Width Widgets (Posts Only)

Bottom Full Width Widgets (Posts/Pages Only)

Bottom Full Width Widgets (Every Page)

Top Widgets (Home Page Only)

Top Widgets (Posts Only)

Top Widgets (Posts/Pages Only)

Top Widgets (Every Page)

Bottom Widgets (Home Page Only)

Bottom Widgets (Posts Only)

Bottom Widgets (Posts/Pages Only)

Bottom Widgets (Every Page)

Post Bottom Widgets

Footer 1

Footer 2

Footer 3

Footer 4