BlockMe Documentation

Introduction

BlockMe is a minimalist, block based WordPress theme for blogging websites and writers. It features full site editing, block patterns, a responsive and mobile-friendly design, a header navigation menu, wide and full-width block alignments, custom colors and typography through Global Styles, RTL language support, and more. The theme employs a lightweight design and optimized code for faster page load speeds, and it is very starter-friendly and easy to set up.

Quick Start Guide

  1. Install & activate the theme via Appearance → Themes → Add New.
  2. Set up your navigation menu by going to Appearance → Editor and editing the Navigation block in the header.
  3. Set your site identity: enter the site title and tagline under Settings → General, and add your logo using the Site Logo block in the header.
  4. Customize by going to Appearance → Editor → Styles. Set up your colors, typography, and layout options for the whole site.

Theme Features

  • Full Site Editing (Block Theme)
  • 6 Block Patterns (Header, Footer, Hero, Posts List, Newsletter, 404)
  • 8 Block Templates and 2 Template Parts (Header, Footer)
  • Responsive Design
  • One-Column Layout
  • Header Navigation Menu (Block Based)
  • Custom Logo Support
  • Custom Colors via Global Styles
  • Wide and Full-Width Block Alignments
  • Featured Images Support
  • Custom Featured Image Size (720 × 540)
  • Threaded Comments
  • Editor Styles
  • Bundled Poppins Font
  • RTL Language Support
  • Translation Ready

Theme Installation

Requirements: BlockMe requires WordPress 6.0 or higher and PHP 7.2 or higher. The theme is tested up to WordPress 6.7. Make sure your site meets these requirements before installing.

Method 1: Install via WordPress Dashboard (Recommended)

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

Method 2: Upload via WordPress Dashboard

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

Method 3: Upload via FTP/File Manager

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

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

Import Demo Content

You can fill your site with sample posts, pages, and media similar to the content shown in the BlockMe theme demo.

Manual Demo Import

Step 1: Import Main Site Content

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

The XML file below is exported directly from the BlockMe demo site and contains the same posts, pages, images, categories, tags, and comments used on the demo:

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

After importing, see the Menu Setup section to select a navigation menu for the header.

BlockMe is a block theme: it does not include widget areas or Customizer settings, so there are no widget (.wie) or Customizer (.dat) files to import. Widgets and theme options are replaced by blocks and the Site Editor (Appearance → Editor), where you can edit the header, footer, templates, and styles directly.

Regenerate Thumbnails

If your website already has existing posts with featured images, it's highly recommended to regenerate thumbnails after activating the BlockMe theme. This ensures that all images match the new theme's layout and display sizes.

Regenerating thumbnails is optional if your site is completely new and doesn't have any uploaded images yet.

However, if you imported the demo content, regenerating thumbnails is essential to display images correctly across the site.

  1. Install and activate the Regenerate Thumbnails plugin.
  2. Go to Tools → Regenerate Thumbnails.
  3. Click the "Regenerate Thumbnails for All x Attachments" button to start the process.
  4. Wait until all images are regenerated. This may take a few minutes depending on your media library size.
  5. If you want, you can deactivate and delete the plugin once the process is complete.

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

Templates

BlockMe is a block theme, so its page layouts are block templates that you can view and edit under Appearance → Editor → Templates. The theme includes the following templates:

  • Index — Main fallback template (templates/index.html)
  • Home — Blog posts index page (templates/home.html)
  • Front Page — The front page of your site, with the hero area, posts list, and newsletter sections (templates/front-page.html)
  • Single — Single post template (templates/single.html)
  • Page — Static page template (templates/page.html)
  • Archive — Category, tag, author, and date archives (templates/archive.html)
  • Search — Search results page (templates/search.html)
  • 404 — Page not found (templates/404.html)

The site header and footer are reusable template parts (parts/header.html and parts/footer.html) shared by all templates. You can edit them under Appearance → Editor → Patterns → Template Parts. A newsletter call-to-action section is also included at the bottom of every template (index, home, front page, single, page, archive, and search).

How to edit or create a template

  1. Go to Appearance → Editor → Templates.
  2. Click the template you want to edit and use the block editor to customize its layout.
  3. To create a new custom template, click the + button, choose a starting layout, and save it.
  4. Assign a custom template to a page or post using the Template panel in the editor's settings sidebar.

BlockMe uses a one-column layout. The default content width is 770px, and wide-aligned blocks can extend up to 1070px.

Block Patterns

BlockMe ships with ready-made block patterns that you can insert into any template, page, or post. All theme patterns are grouped under the BlockMe category in the block inserter. The theme includes the following patterns:

  • Default header — Site logo, site title, tagline, and the navigation menu (blockme/header)
  • Default footer — About text with social links, contact details, recent posts, and the copyright bar (blockme/footer)
  • Hero area — Full-width cover section with a bundled background image, heading, text, and a call-to-action button (blockme/hero)
  • Posts list — List of posts with featured image, title, meta data, excerpt, "Continue Reading" link, and pagination (blockme/posts-list). The theme limits excerpts to 25 words followed by "...".
  • Newsletter area — Newsletter call-to-action section with heading, text, and subscribe button (blockme/newsletter)
  • 404 page — "Oops! That page can not be found." heading, description, and search field (blockme/404)

How to insert a pattern

  1. Open the editor for a template, page, or post.
  2. Click the + (Add block) button to open the block inserter.
  3. Switch to the Patterns tab and open the BlockMe category.
  4. Click a pattern to insert it, then customize its blocks as needed.

The header, footer, hero, and newsletter patterns included in the theme's templates contain placeholder text (for example, "Lorem ipsum" paragraphs and the "Subscribe to Our Newsletter!" section). Replace this placeholder content with your own by editing the templates in the Site Editor.

Translation & RTL

BlockMe 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 blockme.pot file located in the /languages folder inside the theme directory. You can use this file to create translations in your own language using any of the following tools:

After translating, save your files as:

  • blockme-[language_code].po
  • blockme-[language_code].mo

Place them inside the /languages folder in the theme.

If you translate the theme into your language, you can send your translation files to support@themesdna.com so they can be bundled with a future theme update.

↔️ RTL Language Support

BlockMe 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 blocks, 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 BlockMe:

  • 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 posts list 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 BlockMe theme. If you can't find your answer here, you can contact our support team for more help.

Where are the Customizer theme options?

BlockMe is a block theme, so the Customizer is not used. Colors, typography, and layout options are managed in the Site Editor under Appearance → Editor → Styles.

How do I set up my navigation menu?

The header contains one Navigation block. Go to Appearance → Editor, select the Navigation block in the header, and use its Menu options button to create or select a menu. See the Navigation Menus section for full steps.

How do I add social media links?

Edit the footer under Appearance → Editor (Patterns → Template Parts → Footer) and update the Social Links blocks (X/Twitter, Facebook, YouTube, Instagram, LinkedIn) with your own profile URLs.

How do I change the footer copyright text?

Edit the footer template part in the Site Editor. By default, the footer shows a "Copyright © [year] [site title]" line and a "Design by ThemesDNA.com" credit; click on either paragraph and replace it with your own text.

How do I change the number of posts displayed on the blog?

This is not a theme specific setting. Go to Settings → Reading and change the "Blog pages show at most" option. You can also follow this guide: How to Change the Number of Posts per Page in WordPress.

How do I use a static page as my homepage?

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

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.

Images look cropped or misaligned in the posts list

BlockMe uses a 720 × 540 cropped featured image size. Run Regenerate Thumbnails from Tools → Regenerate Thumbnails so existing images match the theme's expected size. Make sure posts have featured images set.

My changes in the Site Editor are not showing on the live site

Make sure you clicked Save in the Site Editor. If you use a caching plugin or CDN, clear the caches after saving.

The hero and newsletter sections show placeholder text

These sections are theme patterns with placeholder content (for example, "Lorem ipsum" text). The hero section appears on the front page template, and the newsletter section is included at the bottom of every template. Edit them in Appearance → Editor → Templates and replace the placeholder blocks with your own content.

Support & Licensing

The BlockMe 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

Changelog & Versioning

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

= Version 1.0.3 =

  • Fixed coding issues.
  • theme.json updated.

= Version 1.0.2 =

  • Fixed block alignment issue.

= Version 1.0.1 =

  • Added "block-patterns" tag.

= Version 1.0.0 =

  • Initial Release.