Documentation - ListMode WordPress Theme

Introduction

ListMode 1.0.5 is a responsive, minimalist WordPress theme for bloggers who want to present content in a clean four-column list layout. It includes a featured-posts slider, one responsive primary menu, sticky header and sidebar behavior, a right sidebar, four footer columns, header image and custom background support, full-width templates for posts and pages, 60+ social profile links, RTL and translation support, WooCommerce integration, and a scroll-to-top button.

Download Theme Live Demo Upgrade to PRO

Quick Start Guide

Install & activate the theme via Appearance → Themes → Add New.
Set up your menu at Appearance → Menus and assign it to Primary Menu.
Configure widgets at Appearance → Widgets.
Customize at Appearance → Customize → Theme Options.

Requirements: WordPress 5.0 or later and PHP 7.2 or later. ListMode 1.0.5 is tested up to WordPress 6.8.

Theme Features

Responsive four-column post summaries
Featured posts slider with recent, category, and tag sources
Sticky header and sticky sidebar
One responsive navigation menu (Primary Menu)
One right sidebar and four footer widget columns
17 widget areas, including full-width and homepage-only areas
60+ social profile links, including Bluesky
Custom logo, flexible header image, and custom background support
Author bio box and featured images
Full-width templates for posts and pages
WooCommerce gallery support
RTL and translation support
Loading animation, responsive videos, and back-to-top button

Theme Installation

Method 1: Install via WordPress Dashboard (Recommended)

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

Method 2: Upload via WordPress Dashboard

Download the listmode.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 listmode.zip file, and click Install Now.
After installation, click Activate.

Method 3: Upload via FTP/File Manager

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

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 listmode.zip file.

Import Demo Content

You can import the demo content, widgets, and Customizer settings shown in the ListMode 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 ListMode 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.

ListMode registers three image sizes: 1320 pixels wide with proportional height, 920 pixels wide with proportional height, and a cropped 100 × 100 pixel thumbnail. Regenerating thumbnails creates these sizes for images uploaded before the theme was activated.

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

Header Image

Use the WordPress Customizer to add or manage the flexible header image shown above the site header.

How to add a header image

Go to Appearance → Customize → Header Image. Header Image is a top-level WordPress Customizer section, not a subsection of Theme Options.
Click Add new image and choose or upload an image. The configured header size is 1920 × 400 pixels, with flexible width and height.
Crop if prompted, then click Publish.

Useful options

Hide Header Image from Everywhere — remove the header image globally.
Remove Link from Header Image — keep the image but remove its link.
Hide both Title and Description, Hide Title, or Hide Description — control the overlaid text.
Show Header Image Title/Description on Smaller Screens — display either text element on small screens.
Add Custom Title/Custom Description — replace the default site title and tagline in the image area.
Header Image Destination URL — set a custom link target.
Add a Minimum Height to Header Image on Smaller Screens — enable and set a mobile minimum height.
Header Image Alt Text — supply alternative text for the image.

The header image uses the site title and tagline by default unless custom header-image text is enabled.

Navigation Menus

This theme registers one Display Location: Primary Menu.

If no custom menu is assigned, ListMode displays a fallback page menu with a Home link. To create and assign a custom menu:

Go to Appearance → Menus and click the create a new menu link.
Enter a name in the Menu Name field.
Select Primary Menu under Display location.
Click Create Menu.
Add pages, posts, categories, tags, or custom links from the left-hand column.
Drag items beneath a parent item to create dropdowns, then click Save Menu.

Widget Areas

There are 17 widget areas in ListMode. The theme does not bundle custom widgets; use WordPress widgets or widgets supplied by plugins.

Sidebar 1 Widgets
Located in the right-hand sidebar.
Top Full Width Widgets (Default HomePage)
After the primary menu on the default latest-posts homepage.
Top Full Width Widgets (Everywhere)
After the primary menu on every page.
Above Content Widgets (Default HomePage)
Above main content on the default latest-posts homepage.
Above Content Widgets (Everywhere)
Above main content on every page.
Below Content Widgets (Default HomePage)
Below main content on the default latest-posts homepage.
Below Content Widgets (Everywhere)
Below main content on every page.
Bottom Full Width Widgets (Default HomePage)
Before the footer on the default latest-posts homepage.
Bottom Full Width Widgets (Everywhere)
Before the footer on every page.
Single Post Bottom Widgets
At the bottom of single posts except attachments and pages.
Footer Top
Above the four footer columns.
Footer 1
Footer column 1.
Footer 2
Footer column 2.
Footer 3
Footer column 3.
Footer 4
Footer column 4.
Footer Bottom
Below the footer columns.
404 Page Widgets
Displayed on the 404 (not found) page.

Page Templates

ListMode includes two full-width templates without sidebars, one for pages and one for posts.

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 (for example, 1320px or larger) for best presentation in full-width layouts.

Customizer Theme Options

To see the ListMode-specific Customizer options:

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

Site Identity, Colors, Header Image, and Background Image are top-level WordPress Customizer sections. The remaining ListMode sections documented below are inside 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 and used by WordPress throughout the site.	Text	A string	Installer-set site title
blogdescription	Tagline	Short description displayed with the site title when enabled.	Text	A string	Just another WordPress site
display_header_text	Display Site Title & Tagline	Shows or visually hides the site title and tagline while retaining accessible markup.	Toggle Switch	true / false	true
site_icon	Site Icon (Favicon)	Image used for browser tabs, bookmark tiles, and WordPress mobile apps; 512 × 512 pixels is recommended.	Media Uploader	Integer (attachment ID)	0 (none)
logo_location	Logo Location	Select how you want to display the site logo with site title and tagline.	Dropdown	Before Site Title and Tagline Above Site Title and Tagline	Above Site Title and Tagline
no_limit_logo_width	Do not Limit the Logo Width	Enables or disables this setting.	Checkbox	true / false	false
logo_max_width	Max Width of the Logo	Enter the max-width value for the logo. Default value is "320px". Note: This option has no effect if you check the "Do not Limit the Logo Width" option.	Text	A valid CSS length (for example, 10px)	320px

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	Sets the site background color. Remove the background image first for the color to be visible.	Color Picker	Hex color code (for example, #ffffff)	#ffffff
header_textcolor	Header Text Color	Sets the color used for the site title and tagline.	Color Picker	Hex color code (for example, #ffffff)	#ffffff

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 flexible header image. The configured size is 1920 × 400 pixels.	Media Uploader	Image URL	(none)
hide_header_image	Hide Header Image from Everywhere	Enables or disables this setting.	Checkbox	true / false	false
remove_header_image_link	Remove Link from Header Image	Enables or disables this setting.	Checkbox	true / false	false
hide_header_image_details	Hide both Title and Description from Header Image	If you checked this option, header image title and description will be hidden from all screen sizes.	Checkbox	true / false	false
hide_header_image_title	Hide Title from Header Image	If you checked this option, header image title will be hidden from all screen sizes. This option has no effect if you have checked the option: "Hide both Title and Description from Header Image"	Checkbox	true / false	false
hide_header_image_description	Hide Description from Header Image	If you checked this option, header image description will be hidden from all screen sizes. This option has no effect if you have checked the option: "Hide both Title and Description from Header Image"	Checkbox	true / false	false
header_image_title_mobile	Show Header Image Title on Smaller Screens	This option has no effect if you have checked any of these options: "Hide both Title and Description from Header Image", "Hide Title from Header Image"	Checkbox	true / false	false
header_image_description_mobile	Show Header Image Description on Smaller Screens	This option has no effect if you have checked any of these options: "Hide both Title and Description from Header Image", "Hide Description from Header Image"	Checkbox	true / false	false
header_image_custom_text	Add Custom Title/Custom Description to Header Image	Enables or disables this setting.	Checkbox	true / false	false
header_image_custom_title	Header Image Custom Title	Sets the value used by this theme option.	Text	A string	(empty)
header_image_custom_description	Header Image Custom Description	Sets the value used by this theme option.	Text	A string	(empty)
header_image_destination	Header Image Destination URL	Enter the URL a visitor should go when he/she clicks on the header image. If you did not enter a URL below, the header image will be linked to the homepage of your website.	Text	A valid URL	(empty)
header_image_cover	Add a Minimum Height to Header Image on Smaller Screens	Enables or disables this setting.	Checkbox	true / false	false
header_image_height_mobile	Header Image Minimum Height on Smaller Screens	Enter the minimum height value for header image height. Default is "200px". Note: This option has no effect until you check "Add a Minimum Height to Header Image on Smaller Screens" option.	Text	A valid CSS length (for example, 10px)	200px
header_image_alt_text	Header Image Alt Text	Sets the value used by this theme option.	Text	A string	Current site title

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	(none)
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)	Sets the horizontal position of the background image.	Radio	Left / Center / Right	Left
background_position_y	Image Position (Vertical)	Sets the vertical position of the background image.	Radio	Top / Center / Bottom	Top
background_size	Image Size	Sets how the background image is sized.	Dropdown	Auto / Contain / Cover	Auto
background_repeat	Repeat Background Image	Controls whether the background image repeats.	Checkbox	Repeat / No Repeat	Repeat
background_attachment	Scroll with Page	Controls whether the background image scrolls with the page or remains fixed.	Checkbox	Scroll / Fixed	Fixed

Menu Options

Below is the complete list of Menu Options available:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
primary_menu_text	Primary Menu Mobile Text	Sets the value used by this theme option.	Text	A string	Menu
disable_primary_menu	Disable Primary Menu	Enables or disables this setting.	Checkbox	true / false	false

Header Options

Below is the complete list of Header Options available:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
hide_tagline	Hide Tagline	Enables or disables this setting.	Checkbox	true / false	false
enable_sticky_header	Enable Sticky Header	Enables or disables this setting.	Checkbox	true / false	false
enable_sticky_mobile_header	Enable Sticky Header on Small Screen	Enables or disables this setting.	Checkbox	true / false	false
hide_header_content	Hide Header Content	Enables or disables this setting.	Checkbox	true / false	false
hide_social_buttons	Hide Header Social + Search + Login/Logout Buttons	If checked, all social, search, and login/logout buttons disappear from the header. The "Show Login/Logout Button" and "Hide Search Button" settings have no effect while this option is enabled.	Checkbox	true / false	false
show_login_button	Show Login/Logout Button	This option has no effect if you checked the option: "Hide Header Social + Search + Login/Logout Buttons"	Checkbox	true / false	false
hide_search_button	Hide Search Button	This option has no effect if you checked the option: "Hide Header Social + Search + Login/Logout Buttons"	Checkbox	true / false	false
header_padding	Header Padding	Enter the padding value for header content. Default is "10px"	Text	A valid CSS length (for example, 10px)	10px

Slider Options

Below is the complete list of Slider Options available:

Slider Display Location: Home Page means the unpaginated latest-posts front page; Static Home Page means a static page assigned as the front page; Blog Posts Index Page means the unpaginated page assigned to show posts. Known ListMode 1.0.5 issue: the Everywhere value is handled by the same fallback condition as Home Page, so it does not display the slider on every view.

Option ID	Option Name	Description	Control Type	Accepted Value	Default
enable_slider	Enable Slider	Enables or disables this setting.	Checkbox	true / false	false
show_slider_heading	Show Slider Heading	Enables or disables this setting.	Checkbox	true / false	false
slider_heading	Slider Heading	Sets the value used by this theme option.	Text	A string	Featured Posts Slider
slider_display	Slider Display Location	Select the slider display location. In ListMode 1.0.5 the Everywhere choice is affected by the implementation issue described above.	Dropdown	Home Page Static Home Page Blog Posts Index Page Everywhere	Home Page
slider_length	Number of Posts on Slider	Enter the number of posts you need to display in the slider area. Default is 10 posts.	Text	A positive integer greater than zero	10
slider_post_type	Slider Posts Type	Select a post type to display in the slider.	Dropdown	Recent Posts Category Posts Tag Posts	Recent Posts
slider_cat	Slider Posts Category	Enter a category term ID when "Slider Posts Type" is Category Posts. In ListMode 1.0.5 this is registered as a text-like custom input rather than a populated category dropdown.	Text-like Custom Input	A non-negative category term ID	0
slider_tag	Slider Posts Tag	Enter a tag term ID when "Slider Posts Type" is Tag Posts. In ListMode 1.0.5 this is registered as a text-like custom input rather than a populated tag dropdown.	Text-like Custom Input	A non-negative tag term ID	0
slider_post_orderby	Slider Posts Orderby	Select a posts orderby value for slider.	Dropdown	Published Date Modified Date Number of Comments	Published Date
slider_post_order	Slider Posts Order	Select a posts order value for slider.	Dropdown	Ascending order Descending order	Descending order
hide_thumbnail_slider	Hide Featured Images from Slider	Enables or disables this setting.	Checkbox	true / false	false
hide_default_thumbnail_slider	Hide Default Featured Image from Slider	The default thumbnail image is shown when there is no featured image is set.	Checkbox	true / false	false
remove_thumbnail_slider_link	Remove Links from Slider Featured Images	Enables or disables this setting.	Checkbox	true / false	false
hide_post_title_slider	Hide Post Titles from Slider	Enables or disables this setting.	Checkbox	true / false	false
remove_post_title_slider_link	Remove Links from Slider Post Titles	Enables or disables this setting.	Checkbox	true / false	false
limit_slider_post_titles	Limit the Length of Slider Post Titles	Enables or disables this setting.	Checkbox	true / false	false
post_title_length_slider	Maximum Length of Slider Post Titles	Enter the maximum number of words need to display in slider post titles. Default is 6 words. This option only work if you have checked the option "Limit the Length of Slider Post Titles".	Text	A positive integer greater than zero	6
hide_slide_author	Hide Post Authors from Slider	Enables or disables this setting.	Checkbox	true / false	false
remove_slide_author_link	Remove Links from Slider Post Authors	Enables or disables this setting.	Checkbox	true / false	false
hide_slide_date	Hide Posted Dates from Slider	Enables or disables this setting.	Checkbox	true / false	false
slider_dateformat	Slider Date Format	Default value: F j, Y	Text	A valid PHP date format string	F j, Y
slide_date_type	Slider Post Date Type	You can choose to display published or updated date of your post.	Dropdown	Published Updated	Published
show_slide_comments	Show Post Comments on Slider	Enables or disables this setting.	Checkbox	true / false	false
show_slide_cats	Show Post Categories on Slider	Enables or disables this setting.	Checkbox	true / false	false
remove_slide_cats_link	Remove Links from Slider Post Categories	Enables or disables this setting.	Checkbox	true / false	false
slide_cat_links_text	Slider Post Categories Pre Text	Enter a text to display before post categories. For example, you can add the text "Posted in:".	Text	A string	(empty)
show_slide_tags	Show Post Tags on Slider	Enables or disables this setting.	Checkbox	true / false	false
remove_slide_tags_link	Remove Links from Slider Post Tags	Enables or disables this setting.	Checkbox	true / false	false
slide_tag_links_text	Slider Post Tags Pre Text	Enter a text to display before post tags. For example, you can add the text "Tagged:".	Text	A string	(empty)
hide_post_snippet_slider	Hide Post Snippets from Slider	Enables or disables this setting.	Checkbox	true / false	false
snippet_type_slider	Post Snippets Type of Slider	Selects the value used by this theme option.	Dropdown	Post Excerpt Post Content	Post Excerpt
snippet_length_slider	Post Snippets Length of Slider	Enter the number of words need to display in slider post summaries. Default is 20 words. This option only work if you have selected "Post Content" value for "Post Snippets Type of Slider" option. To change "Post Excerpt" length, go to Appearance : Customize : Theme Options : Posts Summaries Options : Post Snippets Length of Posts Summaries.	Text	A positive integer greater than zero	20
slider_autoplay	Enable Autoplay for Slider	Enables or disables this setting.	Checkbox	true / false	false
slider_autoplayhoverpause	Enable "Pause on Mouse Hover" Feature for Slider	When you enable this feature, slides will pause on mouse hover. This option has no effect until you check the option "Enable Autoplay for Slider".	Checkbox	true / false	false
slider_autoplaytimeout	Slider "Autoplay Interval Timeout"	Enter the slider autoplay interval timeout in milliseconds. Default is 1000. This option has no effect until you check the option "Enable Autoplay for Slider".	Text	A positive integer greater than zero	1000
slider_autoplayspeed	Slider "Autoplay Speed"	Enter the slider autoplay speed in milliseconds. Default is 200. This option has no effect until you check the option "Enable Autoplay for Slider".	Text	A positive integer greater than zero	200
slider_loop	Enable "Loop" Feature for Slider	When you enable this feature, it will duplicate last and first slide items to get loop illusion.	Checkbox	true / false	false
show_dots_pagination	Show Dots Navigation(Pagination) on Slider	Enables or disables this setting.	Checkbox	true / false	false
hide_next_prev_navigation	Hide next/prev Buttons(Navigation) from Slider	Enables or disables this setting.	Checkbox	true / false	false
enable_autoheight	Enable "Auto Height" Feature on Slider	Enables or disables this setting.	Checkbox	true / false	false

Posts Summaries Options

Below is the complete list of Posts Summaries Options available:

To display these post summaries on the default homepage, go to Settings → Reading and set Your homepage displays to Your latest posts.

Option ID	Option Name	Description	Control Type	Accepted Value	Default
hide_posts_heading	Hide HomePage Posts Heading	Enables or disables this setting.	Checkbox	true / false	false
posts_heading	HomePage Posts Heading	Sets the value used by this theme option.	Text	A string	Recent Posts
hide_thumbnail_home	Hide Thumbnails from Posts Summaries	Enables or disables this setting.	Checkbox	true / false	false
hide_default_thumbnail_home	Hide Default Images from Posts Summaries	Enables or disables this setting.	Checkbox	true / false	false
remove_thumbnail_home_link	Remove Links from Thumbnails of Posts Summaries	Enables or disables this setting.	Checkbox	true / false	false
hide_post_title_home	Hide Post Titles from Posts Summaries	Enables or disables this setting.	Checkbox	true / false	false
remove_post_title_home_link	Remove Links from Post Titles of Posts Summaries	Enables or disables this setting.	Checkbox	true / false	false
limit_post_titles_home	Limit the Length of Post Titles of Posts Summaries	Enables or disables this setting.	Checkbox	true / false	false
post_title_home_length	Maximum Length of Post Titles of Posts Summaries	Enter the maximum length of post titles for post summaries on the homepage.	Text	A positive integer greater than zero	6
hide_post_author_home	Hide Post Authors from Posts Summaries	Enables or disables this setting.	Checkbox	true / false	false
remove_post_author_home_link	Remove Links from Post Authors of Posts Summaries	Enables or disables this setting.	Checkbox	true / false	false
hide_post_date_home	Hide Post Dates from Posts Summaries	Enables or disables this setting.	Checkbox	true / false	false
post_date_home_type	Post Date Type of Posts Summaries	Select the type of post date to display in post summaries on the homepage.	Text	published / updated	published
show_comments_link_home	Show Comment Links from Posts Summaries	Enables or disables this setting.	Checkbox	true / false	false
show_post_categories_home	Show Post Categories on Posts Summaries	Enables or disables this setting.	Checkbox	true / false	false
remove_post_categories_home_link	Remove Links from Post Categories of Posts Summaries	Enables or disables this setting.	Checkbox	true / false	false
cat_links_text	Post Categories Pre Text	Enter the pre-text for post categories in post summaries on the homepage.	Text	A string	(empty)
show_post_tags_home	Show Post Tags on Posts Summaries	Enables or disables this setting.	Checkbox	true / false	false
remove_post_tags_home_link	Remove Links from Post Tags of Posts Summaries	Enables or disables this setting.	Checkbox	true / false	false
tag_links_text	Post Tags Pre Text	Enter the pre-text for post tags in post summaries on the homepage.	Text	A string	(empty)
hide_post_snippet	Hide Post Snippets from Posts Summaries	Enables or disables this setting.	Checkbox	true / false	false
read_more_length	Post Snippets Length of Posts Summaries	Enter the length of post snippets for post summaries on the homepage.	Text	A positive integer greater than zero	15
show_read_more_button	Show Read More Buttons on Posts Summaries	Enables or disables this setting.	Checkbox	true / false	false
read_more_text	Read More Text	Sets the value used by this theme option.	Text	A string	Continue Reading
mini_post_padding	Posts Summaries Padding	Enter the padding for post summaries on the homepage.	Text	A valid CSS length (for example, 10px)	8px

Singular Post Options

Below is the complete list of Singular Post Options available:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
thumbnail_link	Featured Image Link	Do you want single post thumbnail to be linked to their post?	Dropdown	Yes No	Yes
hide_thumbnail_single	Hide Featured Image from Single Posts	Enables or disables this setting.	Checkbox	true / false	false
full_thumbnail_single	Activate Full Width Featured Image for Single Posts	Intended to stretch a smaller single-post featured image to the full content width. Known ListMode 1.0.5 issue: the generated CSS selector is missing its class prefix, so enabling this option does not change the image width unless the theme code is corrected.	Checkbox	true / false	false
hide_post_title	Hide Post Header from Single Posts	Enables or disables this setting.	Checkbox	true / false	false
remove_post_title_link	Remove Links from Single Post Titles	Enables or disables this setting.	Checkbox	true / false	false
hide_post_date	Hide Post Date from Single Posts	Enables or disables this setting.	Checkbox	true / false	false
post_date_type	Post Date Type	You can choose to display published or updated date on your post.	Dropdown	Published Updated	Published
hide_post_author	Hide Post Author from Single Posts	Enables or disables this setting.	Checkbox	true / false	false
hide_post_categories	Hide Post Categories from Single Posts	Enables or disables this setting.	Checkbox	true / false	false
hide_post_tags	Hide Post Tags from Single Posts	Enables or disables this setting.	Checkbox	true / false	false
hide_comments_link	Hide Comment Link from Single Posts	Enables or disables this setting.	Checkbox	true / false	false
hide_comment_form	Hide Comments/Comment Form from Single Posts	Enables or disables this setting.	Checkbox	true / false	false
show_post_edit	Show Post Edit Link on Single Posts	Enables or disables this setting.	Checkbox	true / false	false
hide_author_bio_box	Hide Author Bio Box from Single Posts	Enables or disables this setting.	Checkbox	true / false	false
no_underline_content_links	Do not Underline the Links within the Content	Enables or disables this setting.	Checkbox	true / false	false

Post/Posts Navigation Options

Below is the complete list of Post/Posts Navigation Options available:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
hide_post_navigation	Hide Post Navigation from Single Posts	Enables or disables this setting.	Checkbox	true / false	false
hide_posts_navigation	Hide Posts Navigation from Home/Archive/Search Pages	Enables or disables this setting.	Checkbox	true / false	false
posts_navigation_type	Posts Navigation Type	Select posts navigation type you need. If you activate WP-PageNavi plugin, this navigation will be replaced by WP-PageNavi navigation.	Dropdown	Link 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	Do you want the featured image in a page to be linked to its page?	Dropdown	Yes No	Yes
hide_thumbnail_page	Hide Featured Image from Single Pages	Enables or disables this setting.	Checkbox	true / false	false
hide_page_title	Hide Page Header from Single Pages	Enables or disables this setting.	Checkbox	true / false	false
remove_page_title_link	Remove Link from Single Page Titles	Enables or disables this setting.	Checkbox	true / false	false
hide_page_date	Hide Page Date from Single Pages	Enables or disables this setting.	Checkbox	true / false	false
page_date_type	Page Date Type	You can choose to display published or updated date on your page.	Dropdown	Published Updated	Published
hide_page_author	Hide Page Author from Single Pages	Enables or disables this setting.	Checkbox	true / false	false
hide_page_comments	Hide Comment Link from Single Pages	Enables or disables this setting.	Checkbox	true / false	false
hide_page_comment_form	Hide Comments/Comment Form from Single Pages	Enables or disables this setting.	Checkbox	true / false	false
hide_page_edit	Hide Edit Link from Single Pages	Enables or disables this setting.	Checkbox	true / false	false
hide_static_page_title	Hide Page Header from Static Homepage	Enables or disables this setting.	Checkbox	true / false	false
hide_static_page_meta	Hide Page Meta Data (Page Date, Page Author, Comment Link) from Static Homepage	Enables or disables this setting.	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
twitterlink	X URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
facebooklink	Facebook URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
threadslink	Threads URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
pinterestlink	Pinterest URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
linkedinlink	Linkedin URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
instagramlink	Instagram URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
vklink	VK URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
flickrlink	Flickr URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
youtubelink	Youtube URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
vimeolink	Vimeo URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
soundcloudlink	Soundcloud URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
messengerlink	Messenger URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
whatsapplink	WhatsApp URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
tiktoklink	TikTok URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
lastfmlink	Lastfm URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
mediumlink	Medium URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
githublink	Github URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
bitbucketlink	Bitbucket URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
tumblrlink	Tumblr URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
digglink	Digg URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
deliciouslink	Delicious URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
stumblelink	Stumbleupon URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
mixlink	Mix URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
redditlink	Reddit URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
dribbblelink	Dribbble URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
flipboardlink	Flipboard URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
bloggerlink	Blogger URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
etsylink	Etsy URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
behancelink	Behance URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
amazonlink	Amazon URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
meetuplink	Meetup URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
mixcloudlink	Mixcloud URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
slacklink	Slack URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
snapchatlink	Snapchat URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
spotifylink	Spotify URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
yelplink	Yelp URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
wordpresslink	WordPress URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
twitchlink	Twitch URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
telegramlink	Telegram URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
bandcamplink	Bandcamp URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
quoralink	Quora URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
foursquarelink	Foursquare URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
deviantartlink	DeviantArt URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
imdblink	IMDB URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
codepenlink	Codepen URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
jsfiddlelink	JSFiddle URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
stackoverflowlink	Stack Overflow URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
stackexchangelink	Stack Exchange URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
bsalink	BuySellAds URL	Stores the URL for this option. Known ListMode 1.0.5 issue: the front-end mapping renders a Bootstrap icon and title instead of BuySellAds branding.	Text	A valid URL	(empty)
web500pxlink	500px URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
ellolink	Ello URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
discordlink	Discord URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
goodreadslink	Goodreads URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
odnoklassnikilink	Odnoklassniki URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
houzzlink	Houzz URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
pocketlink	Pocket URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
xinglink	XING URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
mastodonlink	Mastodon URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
blueskylink	Bluesky URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
googleplaylink	Google Play URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
slidesharelink	SlideShare URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
dropboxlink	Dropbox URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
paypallink	PayPal URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
viadeolink	Viadeo URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
wikipedialink	Wikipedia URL	Sets the value used by this theme option.	Text	A valid URL	(empty)
skypeusername	Skype Username	Sets the value used by this theme option.	Text	A string	(empty)
emailaddress	Email Address	Sets the value used by this theme option.	Text	A valid email address	(empty)
rsslink	RSS Feed URL	Sets the value used by this theme option.	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	Sets the value used by this theme option.	Text	A string	(empty)
hide_footer_widgets	Hide Footer Widgets	Enables or disables this setting.	Checkbox	true / false	false

Search and 404 Pages Options

Below is the complete list of Search and 404 Pages Options available:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
hide_search_results_heading	Hide Search Results Heading	Enables or disables this setting.	Checkbox	true / false	false
search_results_heading	Search Results Heading	Enter a sentence to display before the search query.	Text	A string	Search Results for:
no_search_heading	No Search Results Heading	Enter a heading to display when no search results are found.	Text	A string	Nothing Found
no_search_results	No Search Results Message	Enter a message to display when no search results are found.	Textarea	Multiline text	Sorry, but nothing matched your search terms. Please try again with some different keywords.
error_404_heading	404 Error Page Heading	Enter the heading for the 404 error page.	Text	A string	Oops! That page can not be found.
error_404_message	Error 404 Message	Enter a message to display on the 404 error page.	Textarea	Multiline text	It looks like nothing was found at this location. Maybe try one of the links below or a search?
hide_404_search	Hide Search Box from 404 Page	Enables or disables this setting.	Checkbox	true / false	false

Other Options

Below is the complete list of Other Options available:

Option ID	Option Name	Description	Control Type	Accepted Value	Default
enable_widgets_block_editor	Enable Gutenberg Widget Block Editor	Enables or disables this setting.	Checkbox	true / false	false
disable_loading_animation	Disable Site Loading Animation	Enables or disables this setting.	Checkbox	true / false	false
disable_sticky_sidebar	Disable Sticky Feature from Sidebar	Enables or disables this setting.	Checkbox	true / false	false
disable_fitvids	Disable FitVids.JS	You can disable fitvids.js script if you are not using videos on your website or if you do not want fluid width videos in your post content.	Checkbox	true / false	false
disable_backtotop	Disable Back to Top Button	Enables or disables this setting.	Checkbox	true / false	false

Translation & RTL

ListMode 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 listmode.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:

listmode-[language_code].po
listmode-[language_code].mo

Place them inside the /languages folder in the theme.

↔️ RTL Language Support

ListMode 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 ListMode:

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

FAQ

In this section, you'll find quick answers to frequently asked questions about ListMode. If you can't find your answer, contact the support team.

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

Go to Appearance → Menus → Manage Locations and assign your menu to Primary Menu.

How do I enable the featured posts slider?

Go to Appearance → Customize → Theme Options → Slider Options, check Enable Slider, choose its display location and post source, then publish your changes.

How do I add social media links?

Go to Appearance → Customize → Theme Options → Social Links Options and enter profile URLs. The configured icons appear in the header social area.

How do I change the footer copyright text?

Go to Appearance → Customize → Theme Options → Footer Options and edit Footer copyright notice.

How do I use a static page as my homepage?

Create a homepage and a blog page.
Go to Settings → Reading.
Select A static page and choose both pages.
Click Save Changes.

How do I disable sticky sidebars?

Go to Appearance → Customize → Theme Options → Other Options and check Disable Sticky Feature from Sidebar.

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.

Post-summary or slider images are misaligned

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

Widgets are not appearing

Go to Appearance → Widgets and make sure widgets are assigned to the correct widget areas. The Enable Gutenberg Widget Block Editor setting changes only the widget-management interface and is disabled by default; toggling it does not control whether assigned widgets render on the front end. Also check page-specific widget-area conditions and clear any page or object cache.

Support & Licensing

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

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

Changelog & Versioning

The following is the release history for ListMode. We recommend using the latest version.

= Version 1.0.5 =

Added Bluesky social media link option.
Improved accessibility for screen readers with enhanced CSS properties.
Updated theme requirements and WordPress compatibility.
Enhanced header text hiding with better accessibility support.
Updated copyright years.
Fixed coding issues.
Theme Customizer updated.
Many improvements.

= Version 1.0.3 =

Fixed coding issues.
Theme Customizer updated.
Many improvements.

= Version 1.0.2 =

Fixed coding issues.
Theme Customizer updated.
Many improvements.

= Version 1.0.1 =

Fixed coding issues.

= Version 1.0.0 =

Initial Release.

Date Formats

You can use the following date format values in the Slider Date Format option. These formats follow the standard PHP date formatting rules used by WordPress. Dates elsewhere in the free theme generally use the date format configured under Settings → General.

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