Documentation - GridMag WordPress Theme

Introduction

GridMag is an elegant and responsive, masonry grid WordPress theme for building attractive gallery websites. It is modern, clean, responsive and designed to display content in a beautiful masonry grid layout. GridMag features a masonry grid post layout, sticky menu and sticky sidebar, social media icons, 2 navigation menus, a header banner, 1 sidebar, 5 footer columns, and many options. GridMag theme also has RTL language support and a translation-ready codebase. The theme is very starter-friendly and easy to set up.

Download Theme Live Demo Upgrade to PRO

Quick Start Guide

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

Theme Features

Responsive Design
Masonry Grid Post Layout
2 Navigation Menus (Primary and Secondary)
Sticky Menu and Sticky Sidebar
1 Sidebar and 5 Footer Widget Columns
Multiple Full-Width Widget Areas
Header Banner Widget Area
60+ Social Profile Links (Header and Footer)
Custom Logo Support
Custom Header Image
Custom Background
Author Bio Box
RTL Language Support
Translation Ready
Back to Top Button
Header Date Display
FitVids.JS for Responsive Videos
Full-Width Page and Post Templates

Theme Installation

Method 1: Install via WordPress Dashboard (Recommended)

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

Method 2: Upload via WordPress Dashboard

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

Method 3: Upload via FTP/File Manager

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

Troubleshooting Installation Issues

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

Import Demo Content

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

Manual Demo Import

Step 1: Import Main Site Content

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

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

Step 2: Import Widgets

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

Step 3: Import Customizer Settings

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

Regenerate Thumbnails

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

Header Image

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

How to add a header image

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

Useful options

Hide Site Title and Description from Header Image – hide the overlaid site title and description text from the header image.

The header image links to your homepage by default. When the header image is displayed, the site title and description are overlaid on top of it.

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.

Widget Areas

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

Header Banner

Located in the header area of the website. Ideal for displaying ads or banners.
Main Sidebar

Located on the right-hand side of your pages/posts.
Top Full Width Widgets (Default HomePage)

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

Full-width area after the header, shown on every page.
Bottom Full Width Widgets (Default HomePage)

Full-width area before the footer, shown on the default homepage (latest posts).
Bottom Full Width Widgets (Everywhere)

Full-width area before the footer, shown on every page.
Top Widgets (Default HomePage)

Above main content (above posts), shown on the default homepage (latest posts).
Top Widgets (Everywhere)

Above main content (above posts), shown on every page.
Bottom Widgets (Default HomePage)

Below main content (below posts), shown on the default homepage (latest posts).
Bottom Widgets (Everywhere)

Below main content (below posts), shown on every page.
Post Bottom Widgets

Appears at the bottom of single posts, before the comments.
Footer Top Widgets

Full-width area above the footer columns.
Footer 1 Widgets

Footer column 1.
Footer 2 Widgets

Footer column 2.
Footer 3 Widgets

Footer column 3.
Footer 4 Widgets

Footer column 4.
Footer 5 Widgets

Footer column 5.
Footer Bottom Widgets

Full-width area below the footer columns.

Page Templates

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

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

How to apply a template

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

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

Customizer Theme Options

To see available WordPress Customizer theme options:

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

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.	Toggle Switch	true / false	true
site_icon	Site Icon (Favicon)	Image ID for the favicon/app-icon (512 × 512 px recommended). Used in browser tabs, bookmark tiles and WP mobile app.	Media Uploader	Integer (attachment ID)	0 (none)

Colors Options

Below is the complete list of Colors Options available:

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

Header Image Options

Below is the complete list of Header Image Options available:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
header_image	Header Image	Upload or select a header image. Suggested width is 1250 pixels.	Media Uploader	Image URL	(none)
hide_header_image_title	Hide Site Title and Description from Header Image	If checked, the site title and description overlay on the header image will be hidden.	Checkbox	true / false	false

Background Image Options

Below is the complete list of Background Image Options available:

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

Header Options

Below is the complete list of Header Options available:

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

Post Options

Below is the complete list of Post Options available:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
hide_posts_heading	Hide HomePage Posts Heading	Hide the heading above the posts grid on the homepage.	Checkbox	true / false	false
posts_heading	HomePage Posts Heading	Custom heading text for the homepage posts area.	Text	A string	Recent Posts
thumbnail_link	Featured Image Link	Whether the featured image in a post should link to its post.	Dropdown	Yes No	Yes
read_more_length	Auto Post Summary Length	Number of words to display in the post summary on posts summaries. Default is 20 words.	Text	A positive integer	20
hide_post_title_home	Hide Post Titles from Posts Summaries	Hide post titles from posts summaries on listing pages.	Checkbox	true / false	false
hide_post_title	Hide Post Headers from Single Posts	Hide the post header (title and meta data) from single posts.	Checkbox	true / false	false
remove_post_title_link	Remove Links from Single Post Titles	Remove the clickable link from single post titles.	Checkbox	true / false	false
show_post_snippet	Show Post Snippets on Posts Summaries	Show post snippets/excerpts on posts summaries.	Checkbox	true / false	false
hide_posted_date_home	Hide Posted Dates from Posts Summaries	Hide posted dates from posts summaries on listing pages.	Checkbox	true / false	false
hide_posted_date	Hide Posted Dates from Single Posts	Hide the posted date on single posts.	Checkbox	true / false	false
hide_post_author_home	Hide Post Authors from Posts Summaries	Hide author names from posts summaries.	Checkbox	true / false	false
hide_post_author	Hide Post Authors from Single Posts	Hide the author name on single posts.	Checkbox	true / false	false
hide_post_categories_home	Hide Post Categories from Posts Summaries	Hide post categories from posts summaries.	Checkbox	true / false	false
hide_post_categories	Hide Post Categories from Single Posts	Hide categories from single posts.	Checkbox	true / false	false
hide_post_tags	Hide Post Tags from Single Posts	Hide tags from single posts.	Checkbox	true / false	false
hide_comments_link_home	Hide Comment Links from Posts Summaries	Hide comment links from posts summaries.	Checkbox	true / false	false
hide_comments_link	Hide Comment Links from Single Posts	Hide the comment link on single posts.	Checkbox	true / false	false
hide_comment_form	Hide Comments/Comment Form from Single Posts	Hide the comments section and comment form from single posts.	Checkbox	true / false	false
hide_post_edit	Hide Post Edit Links from Single Posts	Hide the edit link on single posts (for logged-in users with permission).	Checkbox	true / false	false
hide_thumbnail	Hide Featured Images from Posts Summaries	Hide featured images from posts summaries on listing pages.	Checkbox	true / false	false
hide_thumbnail_single	Hide Featured Images from Single Posts	Hide the featured image on single posts.	Checkbox	true / false	false
hide_author_bio_box	Hide Author Bio Box from Single Posts	Hide the author biography box on single posts.	Checkbox	true / false	false
hide_post_navigation	Hide Post Navigation from Single Posts	Hide the previous/next post navigation on single posts.	Checkbox	true / false	false
hide_posts_navigation	Hide Posts Navigation from Homepage/Archive/Search Pages	Hide the posts navigation on listing pages.	Checkbox	true / false	false
posts_navigation_type	Posts Navigation Type	Select the type of navigation for post listings. If WP-PageNavi plugin is active, it will replace this navigation.	Dropdown	Normal Navigation Numbered Navigation	Numbered Navigation

Page Options

Below is the complete list of Page Options available:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
thumbnail_link_page	Featured Image Link	Whether the featured image in a page should link to its page.	Dropdown	Yes No	Yes
hide_thumbnail_page	Hide Featured Images from Single Pages	Hide the featured image on single pages.	Checkbox	true / false	false
hide_page_title	Hide Page Headers from Single Pages	Hide the page header (title and meta data) from single pages.	Checkbox	true / false	false
remove_page_title_link	Remove Links from Single Page Titles	Remove the clickable link from the page title.	Checkbox	true / false	false
hide_page_date	Hide Posted Dates from Single Pages	Hide the posted date on single pages.	Checkbox	true / false	false
hide_page_author	Hide Page Authors from Single Pages	Hide the author name on single pages.	Checkbox	true / false	false
hide_page_comments	Hide Comment Links from Single Pages	Hide the comment link on single pages.	Checkbox	true / false	false
hide_page_comment_form	Hide Comments/Comment Form from Single Pages	Hide the comments section and comment form from single pages.	Checkbox	true / false	false
hide_page_edit	Hide Edit Links from Single Pages	Hide the edit link on single pages.	Checkbox	true / false	false

Header Social Buttons Options

Below is the complete list of Header Social Buttons Options available. The theme supports 60+ social profile links in the header area, a search button, and a login/logout button.

Option ID	Option Name	Description	Control Type	Accepted Value	Default
hide_header_social_buttons	Hide Header Social + Search + Login/Logout Buttons	If checked, all buttons disappear from header. Overrides individual hide options below.	Checkbox	true / false	false
hide_search_button_header	Hide Search Button from Header	Hide only the search button (no effect if master hide option is enabled).	Checkbox	true / false	false
hide_login_button_header	Hide Login/Logout Button from Header	Hide the login/logout button (no effect if master hide option is enabled).	Checkbox	true / false	false
twitterbutton	Twitter URL	Enter Twitter profile URL.	Text	URL	(empty)
facebookbutton	Facebook URL	Enter Facebook profile URL.	Text	URL	(empty)
googlebutton	Google Plus URL	Enter Google Plus profile URL.	Text	URL	(empty)
pinterestbutton	Pinterest URL	Enter Pinterest profile URL.	Text	URL	(empty)
linkedinbutton	Linkedin Link	Enter LinkedIn profile URL.	Text	URL	(empty)
instagrambutton	Instagram Link	Enter Instagram profile URL.	Text	URL	(empty)
vkbutton	VK Link	Enter VK profile URL.	Text	URL	(empty)
flickrbutton	Flickr Link	Enter Flickr profile URL.	Text	URL	(empty)
youtubebutton	Youtube URL	Enter YouTube channel URL.	Text	URL	(empty)
vimeobutton	Vimeo URL	Enter Vimeo profile URL.	Text	URL	(empty)
soundcloudbutton	Soundcloud URL	Enter SoundCloud profile URL.	Text	URL	(empty)
messengerbutton	Messenger URL	Enter Facebook Messenger URL.	Text	URL	(empty)
whatsappbutton	WhatsApp URL	Enter WhatsApp URL.	Text	URL	(empty)
lastfmbutton	Lastfm URL	Enter Last.fm profile URL.	Text	URL	(empty)
mediumbutton	Medium URL	Enter Medium profile URL.	Text	URL	(empty)
githubbutton	Github URL	Enter GitHub profile URL.	Text	URL	(empty)
bitbucketbutton	Bitbucket URL	Enter Bitbucket profile URL.	Text	URL	(empty)
tumblrbutton	Tumblr URL	Enter Tumblr profile URL.	Text	URL	(empty)
diggbutton	Digg URL	Enter Digg profile URL.	Text	URL	(empty)
deliciousbutton	Delicious URL	Enter Delicious profile URL.	Text	URL	(empty)
stumblebutton	Stumbleupon URL	Enter StumbleUpon profile URL.	Text	URL	(empty)
mixbutton	Mix URL	Enter Mix profile URL.	Text	URL	(empty)
redditbutton	Reddit URL	Enter Reddit profile URL.	Text	URL	(empty)
dribbblebutton	Dribbble URL	Enter Dribbble profile URL.	Text	URL	(empty)
flipboardbutton	Flipboard URL	Enter Flipboard profile URL.	Text	URL	(empty)
bloggerbutton	Blogger URL	Enter Blogger profile URL.	Text	URL	(empty)
etsybutton	Etsy URL	Enter Etsy shop URL.	Text	URL	(empty)
behancebutton	Behance URL	Enter Behance profile URL.	Text	URL	(empty)
amazonbutton	Amazon URL	Enter Amazon profile URL.	Text	URL	(empty)
meetupbutton	Meetup URL	Enter Meetup profile URL.	Text	URL	(empty)
mixcloudbutton	Mixcloud URL	Enter Mixcloud profile URL.	Text	URL	(empty)
slackbutton	Slack URL	Enter Slack workspace URL.	Text	URL	(empty)
snapchatbutton	Snapchat URL	Enter Snapchat profile URL.	Text	URL	(empty)
spotifybutton	Spotify URL	Enter Spotify profile URL.	Text	URL	(empty)
yelpbutton	Yelp URL	Enter Yelp business URL.	Text	URL	(empty)
wordpressbutton	WordPress URL	Enter WordPress profile URL.	Text	URL	(empty)
twitchbutton	Twitch URL	Enter Twitch channel URL.	Text	URL	(empty)
telegrambutton	Telegram URL	Enter Telegram profile URL.	Text	URL	(empty)
bandcampbutton	Bandcamp URL	Enter Bandcamp profile URL.	Text	URL	(empty)
quorabutton	Quora URL	Enter Quora profile URL.	Text	URL	(empty)
foursquarebutton	Foursquare URL	Enter Foursquare profile URL.	Text	URL	(empty)
deviantartbutton	DeviantArt URL	Enter DeviantArt profile URL.	Text	URL	(empty)
imdbbutton	IMDB URL	Enter IMDB profile URL.	Text	URL	(empty)
codepenbutton	Codepen URL	Enter CodePen profile URL.	Text	URL	(empty)
jsfiddlebutton	JSFiddle URL	Enter JSFiddle profile URL.	Text	URL	(empty)
stackoverflowbutton	Stack Overflow URL	Enter Stack Overflow profile URL.	Text	URL	(empty)
stackexchangebutton	Stack Exchange URL	Enter Stack Exchange profile URL.	Text	URL	(empty)
bsabutton	BuySellAds URL	Enter BuySellAds profile URL.	Text	URL	(empty)
web500pxbutton	500px URL	Enter 500px profile URL.	Text	URL	(empty)
ellobutton	Ello URL	Enter Ello profile URL.	Text	URL	(empty)
goodreadsbutton	Goodreads URL	Enter Goodreads profile URL.	Text	URL	(empty)
odnoklassnikibutton	Odnoklassniki URL	Enter Odnoklassniki profile URL.	Text	URL	(empty)
houzzbutton	Houzz URL	Enter Houzz profile URL.	Text	URL	(empty)
pocketbutton	Pocket URL	Enter Pocket profile URL.	Text	URL	(empty)
xingbutton	XING URL	Enter XING profile URL.	Text	URL	(empty)
googleplaybutton	Google Play URL	Enter Google Play app URL.	Text	URL	(empty)
slidesharebutton	SlideShare URL	Enter SlideShare profile URL.	Text	URL	(empty)
dropboxbutton	Dropbox URL	Enter Dropbox profile URL.	Text	URL	(empty)
paypalbutton	PayPal URL	Enter PayPal profile URL.	Text	URL	(empty)
viadeobutton	Viadeo URL	Enter Viadeo profile URL.	Text	URL	(empty)
wikipediabutton	Wikipedia URL	Enter Wikipedia profile URL.	Text	URL	(empty)
skypeusernamebutton	Skype Username	Enter Skype username (not URL).	Text	Username	(empty)
emailaddressbutton	Email Address	Enter email address for contact button.	Text	Email	(empty)
rssbutton	RSS Feed URL	Enter RSS feed URL.	Text	URL	(empty)

Footer Social Buttons Options

Below is the complete list of Footer Social Buttons Options available. The theme supports 60+ social profile links in the footer area, a search button, and a login/logout button.

Option ID	Option Name	Description	Control Type	Accepted Value	Default
hide_footer_social_buttons	Hide Footer Social + Search + Login/Logout Buttons	If checked, all social buttons, search button, and login/logout button will be hidden from the footer.	Checkbox	true / false	false
hide_search_button	Hide Search Button from Footer	Hide the search button from the footer social icons area. Has no effect if "Hide Footer Social + Search + Login/Logout Buttons" is checked.	Checkbox	true / false	false
hide_login_button	Hide Login/Logout Button from Footer	Hide the login/logout button from the footer social icons area. Has no effect if "Hide Footer Social + Search + Login/Logout Buttons" is checked.	Checkbox	true / false	false
twitterlink	Twitter URL	X (Twitter) profile URL.	Text	A valid URL	(empty)
facebooklink	Facebook URL	Facebook profile URL.	Text	A valid URL	(empty)
googlelink	Google Plus URL	Google Plus profile URL.	Text	A valid URL	(empty)
pinterestlink	Pinterest URL	Pinterest profile URL.	Text	A valid URL	(empty)
linkedinlink	Linkedin URL	LinkedIn profile URL.	Text	A valid URL	(empty)
instagramlink	Instagram URL	Instagram profile URL.	Text	A valid URL	(empty)
vklink	VK URL	VK profile URL.	Text	A valid URL	(empty)
flickrlink	Flickr URL	Flickr profile URL.	Text	A valid URL	(empty)
youtubelink	Youtube URL	YouTube channel URL.	Text	A valid URL	(empty)
vimeolink	Vimeo URL	Vimeo profile URL.	Text	A valid URL	(empty)
soundcloudlink	SoundCloud URL	SoundCloud profile URL.	Text	A valid URL	(empty)
messengerlink	Messenger URL	Facebook Messenger URL.	Text	A valid URL	(empty)
whatsapplink	WhatsApp URL	WhatsApp contact URL.	Text	A valid URL	(empty)
lastfmlink	Lastfm URL	Last.fm profile URL.	Text	A valid URL	(empty)
mediumlink	Medium URL	Medium profile URL.	Text	A valid URL	(empty)
githublink	Github URL	GitHub profile URL.	Text	A valid URL	(empty)
bitbucketlink	Bitbucket URL	Bitbucket profile URL.	Text	A valid URL	(empty)
tumblrlink	Tumblr URL	Tumblr blog URL.	Text	A valid URL	(empty)
digglink	Digg URL	Digg profile URL.	Text	A valid URL	(empty)
deliciouslink	Delicious URL	Delicious profile URL.	Text	A valid URL	(empty)
stumblelink	Stumbleupon URL	StumbleUpon profile URL.	Text	A valid URL	(empty)
mixlink	Mix URL	Mix profile URL.	Text	A valid URL	(empty)
redditlink	Reddit URL	Reddit profile URL.	Text	A valid URL	(empty)
dribbblelink	Dribbble URL	Dribbble profile URL.	Text	A valid URL	(empty)
flipboardlink	Flipboard URL	Flipboard profile URL.	Text	A valid URL	(empty)
bloggerlink	Blogger URL	Blogger blog URL.	Text	A valid URL	(empty)
etsylink	Etsy URL	Etsy shop URL.	Text	A valid URL	(empty)
behancelink	Behance URL	Behance portfolio URL.	Text	A valid URL	(empty)
amazonlink	Amazon URL	Amazon profile URL.	Text	A valid URL	(empty)
meetuplink	Meetup URL	Meetup profile URL.	Text	A valid URL	(empty)
mixcloudlink	Mixcloud URL	Mixcloud profile URL.	Text	A valid URL	(empty)
slacklink	Slack URL	Slack workspace URL.	Text	A valid URL	(empty)
snapchatlink	Snapchat URL	Snapchat profile URL.	Text	A valid URL	(empty)
spotifylink	Spotify URL	Spotify profile URL.	Text	A valid URL	(empty)
yelplink	Yelp URL	Yelp business URL.	Text	A valid URL	(empty)
wordpresslink	WordPress URL	WordPress.com blog URL.	Text	A valid URL	(empty)
twitchlink	Twitch URL	Twitch channel URL.	Text	A valid URL	(empty)
telegramlink	Telegram URL	Telegram profile URL.	Text	A valid URL	(empty)
bandcamplink	Bandcamp URL	Bandcamp artist URL.	Text	A valid URL	(empty)
quoralink	Quora URL	Quora profile URL.	Text	A valid URL	(empty)
foursquarelink	Foursquare URL	Foursquare profile URL.	Text	A valid URL	(empty)
deviantartlink	DeviantArt URL	DeviantArt profile URL.	Text	A valid URL	(empty)
imdblink	IMDB URL	IMDb profile URL.	Text	A valid URL	(empty)
codepenlink	Codepen URL	CodePen profile URL.	Text	A valid URL	(empty)
jsfiddlelink	JSFiddle URL	JSFiddle profile URL.	Text	A valid URL	(empty)
stackoverflowlink	Stack Overflow URL	Stack Overflow profile URL.	Text	A valid URL	(empty)
stackexchangelink	Stack Exchange URL	Stack Exchange profile URL.	Text	A valid URL	(empty)
bsalink	BuySellAds URL	BuySellAds profile URL.	Text	A valid URL	(empty)
web500pxlink	500px URL	500px profile URL.	Text	A valid URL	(empty)
ellolink	Ello URL	Ello profile URL.	Text	A valid URL	(empty)
goodreadslink	Goodreads URL	Goodreads profile URL.	Text	A valid URL	(empty)
odnoklassnikilink	Odnoklassniki URL	Odnoklassniki profile URL.	Text	A valid URL	(empty)
houzzlink	Houzz URL	Houzz profile URL.	Text	A valid URL	(empty)
pocketlink	Pocket URL	Pocket profile URL.	Text	A valid URL	(empty)
xinglink	XING URL	XING profile URL.	Text	A valid URL	(empty)
googleplaylink	Google Play URL	Google Play app URL.	Text	A valid URL	(empty)
slidesharelink	SlideShare URL	SlideShare profile URL.	Text	A valid URL	(empty)
dropboxlink	Dropbox URL	Dropbox profile URL.	Text	A valid URL	(empty)
paypallink	PayPal URL	PayPal.me URL.	Text	A valid URL	(empty)
viadeolink	Viadeo URL	Viadeo profile URL.	Text	A valid URL	(empty)
wikipedialink	Wikipedia URL	Wikipedia user page URL.	Text	A valid URL	(empty)
skypeusername	Skype Username	Skype username (not URL).	Text	A plain text username	(empty)
emailaddress	Email Address	Email address for contact.	Text	A valid email address	(empty)
rsslink	RSS Feed URL	RSS feed URL.	Text	A valid URL	(empty)

Footer 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	Custom copyright notice text displayed in the footer.	Text	A string (HTML allowed)	(empty)
hide_footer_widgets	Hide Footer Widgets	Hide all footer widget areas.	Checkbox	true / false	false

Other Options

Below is the complete list of Other Options available:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
enable_sticky_mobile_menu	Enable Sticky Menu on Small Screen	Enable the sticky (fixed) menu on small screen devices.	Checkbox	true / false	false
disable_primary_menu	Disable Primary Menu	Completely disable the primary menu.	Checkbox	true / false	false
disable_secondary_menu	Disable Secondary Menu	Completely disable the secondary menu.	Checkbox	true / false	false
hide_header_date	Hide Header Date	Hide the current date displayed in the header/secondary menu area.	Checkbox	true / false	false
enable_widgets_block_editor	Enable Gutenberg Widget Block Editor	Enable the Gutenberg block-based widget editor instead of the classic widget editor.	Checkbox	true / false	false

Translation & RTL

GridMag 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 gridmag.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:

gridmag-[language_code].po
gridmag-[language_code].mo

Place them inside the /languages folder in the theme.

↔️ RTL Language Support

GridMag 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.

Performance & SEO Tips

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

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

FAQ

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

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

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

How do I show post snippets on the grid?

Go to Appearance → Customize → Theme Options → Post Options and check the Show Post Snippets on Posts Summaries option.

How do I add social media links?

Go to Appearance → Customize → Theme Options → Header Social Buttons (or Footer Social Buttons) and enter your profile URLs for each social network.

How do I change the footer copyright text?

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

How do I use a static page as my homepage?

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

How do I hide the header date?

Go to Appearance → Customize → Theme Options → Other Options and check Hide Header Date.

Troubleshooting

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

Post thumbnails are missing when sharing on social media

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

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

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

The masonry grid layout looks broken

Make sure your posts have featured images set. Run Regenerate Thumbnails if you recently switched to GridMag or imported demo content. Also, ensure JavaScript is not being blocked by your browser or a plugin.

Widgets are not appearing

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

Support & Licensing

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

What's included in free support:

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

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

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

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

Contact Support

Upgrade to GridMag PRO

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

Changelog & Versioning

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

= Version 1.0.8 =

Fixed coding issues.

= Version 1.0.7 =

Many improvements.
Fixed coding issues.

= Version 1.0.6 =

Fixed coding issues.
Customizer updated.

= Version 1.0.5 =

New options added.
Many improvements.
Fixed coding issues.

= Version 1.0.4 =

New options added.
Many improvements.
Fixed coding issues.

= Version 1.0.3 =

Fixed coding issues.

= Version 1.0.2 =

Fixed coding issues.

= Version 1.0.1 =

Added RTL Support.
Fixed coding issues.

= 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