Empathy Documentation

Overview of the theme, its contents, and how to get started with the theme

Pixelwars logo

Thank you for purchasing our theme! If you have a question that this documentation doesn't answer, ask us on our support forums. If you like the theme, please rate it on ThemeForest.

- Pixelwars Team

Support Forums

Sign in to our support forums to ask your question. To open a new topic, you need your Item Purchase Code (where is my purchase code?).

Visit Support Forums

Rate Theme

If you like the theme, you can rate it on your ThemeForest Downloads page.

Rate on ThemeForest

We assume you have basic knowledge of WordPress. In this documentation, you will learn how to install, set up and customize Empathy.

Useful Resources

We've assembled some links to get you started:

Learn WordPress: Level up your WordPress skills.


WordPress Documentation: A variety of resources to help you get the most out of WordPress.


WordPress Support Forums: Community-based Support Forums are a great place to learn, share, and troubleshoot.

Note: The WordPress.org forums don't provide support for commercial themes. For questions about Empathy, please use our support forums.


Free Plugins: The WordPress Plugin Directory is the largest directory of free and open source WordPress plugins. Extend your WordPress experience with plugins.

Install Theme

You can add the theme to your WordPress site in one of the following ways.

Install via Envato Market Plugin

The Envato Market plugin connects your site to your ThemeForest account and installs the themes you purchased.

  • The plugin isn't available on WordPress.org. Download it from the Envato Market page, then install it from Plugins > Add Plugin > Upload Plugin.
  • Go to the "Envato Market" page in your dashboard and connect the plugin to your account with a personal token. The page shows you how to create one.
  • Install and activate the theme from the "Envato Market" page.

The plugin also helps you keep the theme up to date (see the Update section).

Install by Uploading the ZIP File

  • Download the theme package from your ThemeForest account and unzip it. The theme's ZIP file (empathy.zip) is inside the "Theme/1 - Parent Theme" folder of the theme package, in the folder with the current version number.
  • In your dashboard, go to Appearance > Themes > Add Theme > Upload Theme.
  • Click "Choose File", select the theme's ZIP file, and click "Install Now".
  • When the installation is complete, click "Activate".

Note: The "Theme/1 - Parent Theme" folder also has a "Previous Version" folder, with the ZIP file of the previous theme version. Don't install it on a new site. It is there for sites that already use the theme: if your site has a problem after an update, you can go back to the previous version by installing this file (see the Update section).

Note: Your host limits the size of the files you can upload. You can see this limit under Tools > Site Health > Info > Media Handling ("Max size of an uploaded file"). If the theme's ZIP file is larger than this limit, install the theme with one of the ways below, or ask your hosting provider to increase the limit.

Other Ways to Install a Theme

After Installation

  • After you activate the theme, WordPress shows a notice to install the theme's plugins. Go to Appearance > Install Theme Plugins to install them (see the Plugins section).
  • The theme adds a "Theme Options" page under Appearance (see the Customization section).
  • To make your site look like the demo, import the demo content (see the Demo Import section).
  • This theme uses custom image sizes. If you already have images in your Media Library, install and activate the Regenerate Thumbnails plugin, then run it once from Tools > Regenerate Thumbnails.

Child Theme

A child theme inherits the functionality and styling of the parent theme. If you want to change the theme's code, use the child theme: your changes are kept when you update the parent theme (see the Update section).

  • The child theme's ZIP file (empathy-child.zip) is inside the "Theme/2 - Child Theme" folder of the theme package.
  • Install the parent theme first, as described above. Keep it installed, because the child theme needs it.
  • Then install the child theme's ZIP file the same way and activate the child theme.

This theme is coded to high standards to ensure seamless compatibility with plugins.

Theme Plugins

The theme's features, like the pages of your homepage, the contact form and the shortcodes, are built into the theme. Go to Appearance > Install Theme Plugins to install the recommended plugins:

Loco Translate is a free plugin that you can install from Plugins > Add Plugin when you need it (see the Translation section).

Import Demo Data

Importing demo data (posts, pages, theme settings, etc.) is the quickest and easiest way to set up your new theme. It allows you to simply edit everything instead of creating content and layouts from scratch.

System Requirements

Before you import the demo, make sure your server meets our system requirements (WordPress and PHP versions, and PHP limits such as memory and upload size). You can check your current values under Tools > Site Health > Info > Server. If you are not sure whether your server meets them, contact your hosting provider.

Import Methods

First, go to Appearance > Install Theme Plugins, and install and activate the plugins listed there. Then choose one of the following methods. A low upload size limit on your server can stop the import. In this case, you need to increase it; see this article for how to do it.

Method 1: One-Click Import (Recommended)
  • Activate the Pixelwars Portfolio plugin before the import. Otherwise the portfolio items of the demo aren't imported.
  • Go to Appearance > Import Demo Data, choose "Demo Content" and import it.
  • This imports the pages, posts and portfolio items of the demo with their images, the Customizer settings and the widgets, including the pages of the homepage, and sets up the menu and the homepage. Then replace the demo's details with your own (see After the Import below).
Method 2: Manual Import

Use this method if the one-click import doesn't work on your server. The files are in the "Sample Data" folder of the theme package. If the theme has more than one demo, each demo has its own folder.

  • Plugins: Install and activate the plugins used on the demo site (see the Plugins section).
  • Content: Go to Tools > Import. Under "WordPress", click "Install Now" (if the importer isn't installed yet), then "Run Importer". Choose the "01 - All content (all parts).xml" file in the "Sample Data/Demo Content" folder and import it. Check "Download and import file attachments" to import the images too. The other files in the folder have the same content in parts (posts, pages and portfolio items), if you only need some of it.
  • Customizer settings: Install and activate the Customizer Export/Import plugin. Go to Appearance > Customize > Export/Import and import the "customizer.dat" file in the "Sample Data/(Theme) Customizer Settings" folder.
  • Widgets: Install and activate the Widget Importer & Exporter plugin. Go to Tools > Widget Importer & Exporter and import the "widgets.wie" file in the "Sample Data/(Theme) Widget Settings" folder. The widgets also include the pages of the homepage (see the Template Pages section).
  • Menu: Go to Appearance > Menus. In the "Manage Locations" tab, select the imported menu ("Custom Menu") for the "Classic Navigation Menu" location and save changes. The menu is shown when "Classic Navigation Menu" is set to "Yes" in Appearance > Theme Options > Style (see the Menu section).
  • Homepage: Go to Settings > Reading. Under "Your homepage displays", choose "A static page", select "Home" as the homepage and "blog" as the posts page, and save changes.

After the Import

After the import, your site looks like the demo. Replace the demo's details with your own:

  • Contact form: Edit the "contact" page. In the contact form shortcode, replace the demo address (info@johndoe.com) with your email address. The messages are sent to this address (see Contact Page).
  • Map: The "contact" page also shows a map. Enter your location in the map shortcode. For the theme's map style and your marker image, also enter a Google Maps API key in Appearance > Theme Options > General (see Contact Page).
  • Background video: Go to Appearance > Widgets. In the "Empathy Template Pages" widget area, the "(Empathy) [PAGE] Home" widget plays a YouTube video of the demo in the background. Enter your own video in its "Background Video URL" field, or empty the field to show the featured image of your "Home" page instead (see Page Widgets).
  • Footer: In the same screen, add your profile addresses to the social icons of the "Footer Social Icons" widget area (the demo icons link to "#"), and change the text of the "Footer Copyright Text" widget area. The "Instagram" widget in "Footer 2" needs your own feed: set up your Instagram account and a feed in the Social Feed Gallery plugin and select the feed in the widget, or remove the widget.
  • Image sizes: The import doesn't create the theme's image sizes for the demo images. Run the Regenerate Thumbnails plugin once after the import (see After Installation).

The settings of this theme are in two places: the logo, the layout and the blog settings are in Theme Options, and the fonts, the colors and the page animations are in the Customizer.

Theme Options

Go to Appearance > Theme Options. The settings are grouped in four tabs, and each setting has a short help text under it. Click "Save Changes" to save the settings of the open tab.

  • General: Your logo ("Image Logo"), shown in the header above the site title, and the Google Maps API key for the map shortcode (see Contact Page).
  • Style: Links to the fonts and colors in the Customizer, the character sets and font weights of the Google Fonts, the "Classic Navigation Menu" (see the Menu section), and "Mobile Zoom", which lets visitors zoom in on phones and tablets.
  • Layout: "Classic Layout" and "Mobile-Only Classic Layout" show the pages of your homepage as regular scrolling pages, without the page animations (see Colors and Animations). "Ajax Portfolio" opens portfolio items without leaving the homepage (see the Portfolio section).
  • Blog: Excerpts, related posts, numbered pagination and the "Back To Blog" link (see Blog Options).

Customizer

Go to Appearance > Customize. While you change the settings, you can see the changes live on your website. Each setting of the theme has a short description.

  • Site Identity: The site title, shown as the text logo, and the site icon.
  • Fonts: The fonts of the text logo, the menu, the headings and the body text. You can choose from the Google Fonts.
  • Colors: The colors of the text logo and its background, the menu background, the links, the accent color ("Primary Color") and the loading bar.
  • Empathy Page Colors and Empathy Page Animations: The background colors of the pages on your homepage, and the animations between them (see Colors and Animations).

Custom CSS and Code Changes

To add small style changes, use Appearance > Customize > Additional CSS. For changes in the theme's code, use the child theme, so that your changes are kept when you update the theme (see the Installation and Update sections).

Note: Before version 1.4.9, the theme had its own "Custom CSS" box in the Customizer. When you update the theme, the CSS you saved there is moved to Additional CSS automatically, and it keeps working.

For more information

Widgets are independent sections of content that can be placed into widgetized areas.

  1. Go to Appearance > Widgets.
  2. Drag and drop widgets to widget areas (see the Sidebar section).
  3. Save each widget by clicking its "Save" button.

You can also add widgets in Appearance > Customize > Widgets, with a live preview.

Theme Widgets

The theme adds four page widgets: "(Empathy) [PAGE] Home", "(Empathy) [PAGE] Custom", "(Empathy) [PAGE] Blog" and "(Empathy) [PAGE] Portfolio". Each of them shows one of your pages on your homepage. Use them only in the "Empathy Template Pages" widget area (see Page Widgets).

In the footer and at the bottom of the header, use the widgets that come with WordPress, like Text, Custom HTML, Recent Posts and Categories, and the widgets of your plugins, like the Instagram feed of Social Feed Gallery (see the Plugins section).

Note: Version 1.4.9 removed the "(Empathy) Flickr" and "(Empathy) Social Feed" widgets of the first versions of the theme, because the services they used to get the photos were closed. Widget areas that still had them simply don't show them anymore.

Pages are similar to posts in that they have a title, body text, and associated metadata, but they are different in that they are not part of the chronological blog stream, kind of like permanent posts. Pages are not categorized or tagged, but can have a hierarchy. You can nest pages under other pages by making one the "Parent" of the other, creating a group of pages.

Settings Sidebar

When editing a page/post in the WordPress editor, you will find a Settings sidebar on the right-hand side of the screen. This panel contains various options and settings related to the page, such as:

  • Featured Image: Set the main image that represents this page.
  • Template: Select which page template to use.
  • Discussion: Enable or disable comments for the page.

These settings control how the page is displayed. You can find more information about the Settings sidebar in this article.

When you show a page on your homepage, its featured image becomes the background image of the page there (see the Template Pages section).

Create a Page

  1. Go to Pages > Add Page.
  2. Enter title.
  3. Add body text.
  4. Set featured image (optional).
  5. Select a template. (see page templates below)
  6. Publish your page.

Page Template

You can assign a custom template to any page by editing it in the WordPress admin area. To select a custom page template, open the Template dropdown in the settings sidebar.

  • Default Template: WordPress comes with a built-in Default template, which displays the page content using your theme's standard layout. You can use this template for basic pages.
  • Custom Templates: This theme includes custom page templates, each designed for a specific layout. The name of each template clearly indicates how the page content will be displayed. So you can easily understand what kind of layout it provides before applying it.

The theme's page templates:

  • Empathy Homepage: For your homepage. It shows the pages you add to the "Empathy Template Pages" widget area (see the Homepage and Template Pages sections).
  • Full width: The page content uses the full width of the site.
  • Medium width: The page content uses a narrower column.

Write the content of your pages with blocks, and with the theme's shortcodes (see the Shortcodes section). On your homepage, a page shows its title, its content and its featured image; its template is used when the page is opened on its own.

Managing Pages

Managing pages is very similar to managing posts, and the screens can be customized in the same way. You can also perform the same types of actions, including narrowing the list by using the filters, acting on a page using the action links that appear when you hover over a row, or using the Bulk actions menu to edit the metadata for multiple pages at once.

Learn more about Managing Pages.

Useful Resources

Learn how to get the most out of the WordPress block editor when publishing your content.


What Your Homepage Displays

WordPress allows you to choose what your homepage displays. You can use a classic blog page showing your latest posts, or you can assign a static page. If you don't want a blog page on your site, you can set a static homepage only. Creating a blog page is optional. To set a static homepage, simply create (or choose) a page and assign it as the Homepage in Settings > Reading.

Note: Like the demo site, your homepage should be a page with the theme's "Empathy Homepage" template. It shows your pages one at a time, with its own menu. If you import the demo with the one-click import, its "Home" page is set up as your homepage (see the Demo Import section).

Create a Homepage

  • Go to Pages > Add Page.
  • Enter a title, like "Home".
  • In the page settings sidebar, set "Template" to "Empathy Homepage".
  • Publish your page.

Then select this page as your homepage (see below) and add your pages to it (see the Template Pages section). Use only one page with the "Empathy Homepage" template.

The homepage shows the pages you add to the "Empathy Template Pages" widget area, not the content of this page. Like on the demo, you can also select this page in the "(Empathy) [PAGE] Home" widget: then its content and its featured image are the first page of your homepage.

Reading Settings

  • Go to Settings > Reading.
  • Under "Your homepage displays", choose "A static page".
  • Select your page as the "Homepage". If you also want a blog page, create an empty page (for example "Blog") and select it as the "Posts page".
  • Save changes.

Learn more about Reading Settings

How It Works

Your homepage shows several of your pages, one at a time, like "home", "about me", "resume", "portfolio", "blog" and "contact" on the demo site. The page with the "Empathy Homepage" template shows them (see the Homepage section).

  • Each of these pages is a widget in the "Empathy Template Pages" widget area, in Appearance > Widgets. The widget shows one of your pages: its title, its content, and its featured image as the background.
  • The order of the widgets is the order of the pages. The homepage makes its menu from them: each widget adds a menu item with its title and its icon.
  • A click on a menu item changes the page with an animation (see Colors and Animations below). Each page has its own address: the address of your homepage, followed by #/ and the slug of the page, for example https://www.yoursite.com/#/about-me.

Add Your Pages

  1. Go to Pages > Add Page and create the pages you want to show, for example "about me", "resume" and "contact". Write their content with blocks and with the theme's shortcodes (see the Shortcodes section). Set a featured image if you want a background image.
  2. Go to Appearance > Widgets.
  3. Add an "(Empathy) [PAGE]" widget for each page to the "Empathy Template Pages" widget area, in the order you want (see Page Widgets below).
  4. In each widget, select the page in "Select Page", enter the "Title" and the "Icon" of its menu item, and click "Save".

"Title" is the text of the menu item. If you leave it empty, the menu item shows the title of the page. "Icon" is the name of an icon, like pe-7s-user, shown in the menu and before the title of the page (see Icons in the Shortcodes section).

Note: Add only the theme's "[PAGE]" widgets to this widget area, and show each page only once.

Tip: The demo content has these pages and widgets. Import it and edit them (see the Demo Import section).

Page Widgets

  • (Empathy) [PAGE] Home: The intro page, usually the first one. It shows the content of its page without the title, over the featured image of the page. To play a video in the background instead, enter the address of a YouTube or Vimeo video in "Background Video URL (YouTube/Vimeo)": copy it from your browser's address bar.
  • (Empathy) [PAGE] Custom: Any other page, like "about me", "resume" or "contact". It shows the title and the content of its page.
  • (Empathy) [PAGE] Blog: Your latest posts in a grid, below the title and the content of its page. "Layout" arranges the posts as "Masonry" or "FitRows", "Item Width (px)" is the width of a post in the grid (default: 340), and "Show Items" is the number of posts (default: 9). The posts open on their own pages (see Blog Options for their "Back To Blog" link).
  • (Empathy) [PAGE] Portfolio: Your portfolio items with filters for their categories, below the title and the content of its page (see the Portfolio section).

A page without a featured image has the background color of its place on the homepage (see Colors and Animations below).

Contact Page

The "contact" page of the demo shows social icons, contact details, a contact form and a map. Its content is made with the theme's shortcodes, each in a "Shortcode" block, and it is shown with an "(Empathy) [PAGE] Custom" widget. The form and the map look like this:

[section_title text="Drop Me A Line"]

[contact_form to="yourname@example.com" subject="Contact form message"]

[map latitude="-25.363882" longitude="131.044922" zoom="5" image=""]
  • Contact form: The messages are sent to the address in to="". If you leave it empty, they are sent to the administration email address of your site (Settings > General). subject="" is the subject of the messages. The name and email address of the visitor are the "Reply-To" of each message, so you can answer it with the reply button of your email program.
  • Map: Enter the latitude and the longitude of your location (in Google Maps, right-click your location to see them) and the zoom level, for example 5 for a country or 15 for a street. image="" is the address of your own marker image (optional; it needs a Google Maps API key, see below). Without it, the map shows Google's default marker.
  • Google Maps API key (optional): Without a key, the map shows Google's standard map. With a key, it shows the theme's map style and your marker image. Enter the key in Appearance > Theme Options > General ("Google Maps API Key"); the help text there explains how to get a key and how to restrict it to your site.

Note: The form sends the messages through WordPress, with your site name as the sender. If the messages don't arrive, install an SMTP plugin, like WP Mail SMTP, or ask your hosting provider whether your server can send email.

Colors and Animations

Go to Appearance > Customize:

  • Empathy Page Colors: The background colors of the first six pages of your homepage, in the order of the widgets. Check "Page Light Text" for a page with a dark background: its text is shown in white.
  • Empathy Page Animations: "Next Animation" is used when a visitor goes to a later page, and "Previous Animation" when they go back to an earlier page. Choose from 67 effects, or check "Random animation" to use a different effect on each page change.

Go to Appearance > Theme Options > Layout:

  • Classic Layout: The pages change without the animations, and each page scrolls like a regular page, on every screen size.
  • Mobile-Only Classic Layout: The classic layout only on screens narrower than 1025 pixels, like phones and tablets. Wider screens keep the animations.

Here, you will find the information you need to create a blog post. Once you have created your blog post, you can publish it on your blog page. Blog posts have a title, body text, and associated metadata, and they are part of the chronological blog stream. Posts are categorized and tagged, but can not have a hierarchy. Post categories can have a hierarchy. You can nest categories under other categories by making one the "Parent" of the other, creating a group of categories.

If you have any questions about blog page and blog posts, feel free to reach out to us on our support forum. We are happy to assist you!

Let your creativity flow and craft engaging blog posts to share. This will enhance the value of your website and also help it rank higher in search engines.

Settings Sidebar

When editing a page/post in the WordPress editor, you will find a Settings sidebar on the right-hand side of the screen. This panel contains various options and settings related to the page, such as:

  • Featured Image: Set the main image that represents this page.
  • Template: Select which page template to use.
  • Discussion: Enable or disable comments for the page.

These settings control how the page is displayed. You can find more information about the Settings sidebar in this article.

Theme Boxes

The theme adds a "Title Visibility" box to posts: check "Hide title" to hide the title of a post. Portfolio items have a "Type" box (see the Portfolio section).

Create a Blog Page

Creating a blog page in WordPress is simple, and you can do it in just a few steps. Here's how (see also the Homepage section):

  1. In the left-hand menu, go to Pages > Add Page.
  2. Enter a title for your page, such as "Blog".
  3. Leave the content area blank (WordPress will automatically display your blog posts here).
  4. Click "Publish" to save the page.
  5. Go to Settings > Reading in the dashboard. (Learn more about Reading Settings)
  6. Under "Your homepage displays", select "A static page".
  7. Set your "Homepage" to the page you want as your front page.
  8. Set your "Posts page" to the "Blog" page you just created.
  9. Click "Save Changes".
  10. Go to Appearance > Menus.
  11. Select the "Blog" page and add it to your navigation menu.
  12. Click "Save Menu".

Now, whenever you publish a new blog post, it will automatically appear on your blog page. Happy blogging!

To show your latest posts on your homepage too, add an "(Empathy) [PAGE] Blog" widget to it (see Page Widgets).

Post Categories

You can use categories to define sections of your site and group related posts. The default category is "Uncategorized" until you change it in the WordPress Writing settings.

Create a Blog Post

  1. Go to Posts > Add Post.
  2. Enter a title, write your content, and add images.
  3. Set featured image.
  4. Choose a "Category" and "Tags" for better organization.
  5. Choose an appropriate "Format". (see formats below)
  6. Click the "Publish" button to make your post live.

Post Formats

The Post Formats feature in WordPress allows you to use different styles and layouts for various types of content. This feature helps your theme make posts more dynamic and user-friendly.

How to Use Post Formats

On the post edit screen, you can choose the format of a blog post. To do this, open the edit screen of a post and locate the "Format" option in the settings sidebar on the right-hand side.

Note: You can change the post format of an already published post at any time. Simply edit the post and select a different "Format" from the options. WordPress will automatically adjust the layout based on the new format, ensuring that your content remains visually appealing.

Supported Post Formats

WordPress provides a variety of Post Formats, each designed for specific types of content. When creating a post, you can enhance its layout using the WordPress Block Editor.

In the block inserter menu, you will find suitable blocks for each post format. For example, the "Gallery" format supports the "Gallery" block, and the "Video" format supports the "Video" block. To quickly find the right block for a format, simply type the format name (e.g., "Image," "Quote," or "Video") into the block search field. WordPress will automatically suggest the most relevant block for your post format.

This theme supports the following WordPress Post Formats:

  • Standard: Used for classic blog posts. It may include a title, content, and a featured image. Suggested Block: Paragraph, Heading, Image, List.
  • Gallery: Used for posts containing multiple images. Suggested Block: Gallery, Columns.
  • Image: Designed for posts that focus on a large image. Suggested Block: Image, Cover.
  • Video: Ideal for video content. Supports embedded videos from platforms like YouTube and Vimeo. Suggested Block: Video, Embed.
  • Audio: Ideal for audio files, podcasts, or music sharing. Upload an audio file through the "Media Library" or embed it using an embed code. Suggested Block: Audio, Embed.
  • Aside: Suitable for short, informal content or announcements. Suggested Block: Paragraph, Pullquote.
  • Status: Short status updates, similar to social media posts. Suggested Block: Paragraph, Quote.
  • Quote: Highlights a quote, usually displayed with special typography. Suggested Block: Quote, Pullquote.
  • Link: Highlights a single external link. Suggested Block: Button, Paragraph with a Hyperlink.
  • Chat: Formats text to resemble a conversation or chat log. Suggested Block: Paragraph. (See below example)

Example for Chat format

JOHN: Hey there

MARY: Aye, matey!

JOHN: Huh?

Blog Options

This theme has no sidebars on the blog. Go to Appearance > Theme Options > Blog to choose how your blog looks:

  • Automatic Excerpt: Shows a short excerpt with a "Read More" link instead of the full post on the blog, archive and search pages. "Only for standard format" does this only for the posts in the standard format. A post that has its own excerpt always shows it.
  • Related Posts: Shows up to three posts from the same categories below each post.
  • Numbered Pagination: Shows page numbers instead of the "Older Posts" and "Newer Posts" links.
  • Back To Blog Link: Where the "Back To Blog" link in the header of your posts goes. "To Regular Blog" opens your posts page (Settings > Reading), and "To Grid Blog" opens the blog page of your homepage, the page of the "(Empathy) [PAGE] Blog" widget. The link is shown when your homepage is a static page.

Managing Posts

Hovering over a row in the posts list will display action links that allow you to manage your post. You can perform the following actions:

  • Edit takes you to the editing screen for that post. You can also reach that screen by clicking on the post title.
  • Quick Edit provides inline access to the metadata of your post, allowing you to update post details without leaving this screen.
  • Trash removes your post from this list and places it in the Trash, from which you can permanently delete it.
  • Preview will show you what your draft post will look like if you publish it. View will take you to your live site to view the post. Which link is available depends on your post's status.

Learn more about Managing Posts, Categories and Tags.

Useful Resources

Learn how to get the most out of the WordPress block editor when publishing your content.


Activate Portfolio Items

The portfolio comes with the Pixelwars Portfolio plugin. Go to Appearance > Install Theme Plugins, then install and activate "Pixelwars Portfolio". Now you can see the "Portfolio" menu in your dashboard.

Portfolio Menu

  • All: All your portfolio items in a list. They are listed by date, and your portfolio page shows them in the same order. To change the order, change the publish date of an item.
  • Add New: Create a new portfolio item (see below).
  • Portfolio Categories: Group your portfolio items. The categories appear as filters on your portfolio page.

Create a Portfolio Item

  1. Go to Portfolio > Add New.
  2. Enter a title and set a featured image. The featured image is the thumbnail of the item on your portfolio page, and visitors click it to open the item, so every item needs one.
  3. Write a short description in the "Excerpt" box. It is shown under the title of the item. (If you don't see the box, turn it on in "Screen Options" at the top of the screen.)
  4. Choose a category in the "Portfolio Categories" box.
  5. Choose the type of the item in the "Type" box (see below).
  6. Publish your portfolio item.

Portfolio items are edited in the classic editor. Its toolbar also has the theme's "Insert Shortcode" button (see the Shortcodes section).

Portfolio Item Types

The "Type" box decides what happens when a visitor clicks the item on your portfolio page:

  • Standard: Opens the item with its content (see Portfolio Options below). Write the content in the editor. The mini_text shortcode shows a text in a narrower column (see the Shortcodes section).
  • Lightbox Gallery: Opens a gallery of images in a lightbox. Add a gallery to the content of the item with the "Add Media" button of the editor ("Create Gallery").
  • Lightbox Audio: Opens an audio from SoundCloud in a lightbox. In the "URL" field, enter the player address from the embed code of the SoundCloud track (the "src" address of its iframe).
  • Lightbox Video: Opens a video in a lightbox. Enter the address of a YouTube or Vimeo video in the "URL" field.
  • Direct URL: Opens the address you enter in the "URL" field. Check "Open link in new tab" to open it in a new tab.

Portfolio Page

Your portfolio items are shown on your homepage, on the page of an "(Empathy) [PAGE] Portfolio" widget (see the Template Pages section):

  1. Create a page for your portfolio, for example "portfolio". Its title is the heading above your items, and you can also write an introduction in its content.
  2. Go to Appearance > Widgets and add an "(Empathy) [PAGE] Portfolio" widget to the "Empathy Template Pages" widget area.
  3. Select your page in "Select Page" and enter the "Title" and the "Icon" of its menu item. Choose the "Layout" of the grid ("Masonry" or "FitRows") and the width of the thumbnails in "Item Width (px)" (default: 340). Then save the widget.

The portfolio page shows all your portfolio items, with an "All" filter and a filter for each category at the top. When a visitor opens the page on its own, for example from your menu, they are sent to it on your homepage.

Portfolio Options

  • Appearance > Theme Options > Layout: With "Ajax Portfolio" set to "Yes" (the default), Standard items open on your homepage, without leaving the page. With "No", each opens on its own page, with a "Back To Portfolio" link in the header. Lightbox and Direct URL items aren't affected.
  • Settings > Permalinks: Use the "Post name" permalink structure, so that your portfolio items open correctly (see Permalink Settings in the Demo Import section).

The shortcodes are built into the theme, so you don't need a plugin for them. The pages of the demo, like "about me", "resume" and "contact", are built with them (see the Template Pages section).

How to Add a Shortcode

  • Shortcode block: In the block editor, add a "Shortcode" block and paste your shortcode into it. The "contact" page of the demo is built this way.
  • Shortcode generator: In the block editor, add a "Classic" block and click the "Insert Shortcode" button in its toolbar. Choose a shortcode, fill in its fields and insert it. In the editor of portfolio items, the button is in the editor's own toolbar. The other pages of the demo, like "home", "about me" and "resume", keep their shortcodes in a "Classic" block.

Some shortcodes work together: a wrapper shortcode (like row or tabs_wrap) holds item shortcodes (like column or tab_pane), and in a group of icons, toggles or accordions, the first and the last item open and close the group (like first_icon="yes" and last_icon="yes"). Keep them together as in the examples below.

All Shortcodes

row, column

[row]
[column width="8"]Content here.[/column]
[column width="4"]Content here.[/column]
[/row]


width="" ... 1-12. The widths of the columns in a row add up to 12, like 6 + 6 or 4 + 4 + 4.
width_xs="" ... (optional) 1-12. The width on phones (screens narrower than 768 px). Without it, the columns are shown one below the other there.
width_md="" ... (optional) 1-12. The width on screens 992 px and wider.
width_lg="" ... (optional) 1-12. The width on screens 1200 px and wider.

section_title

[section_title text="Services"]


text="" ... The title.

event

[event]
<h2>WORK HISTORY</h2>
[icon name="pe-7s-ribbon"]
[/event]

[event]
<h3>Dec 2013 - Current</h3>
<h4>Front End Web Developer</h4>
<h5>Pixelwars Inc.</h5>
Description.
[/event]

A timeline for your work experience and education, like on the "resume" page of the demo. The first event is the title of the group: a Heading 2 with an icon. Each next event has the date as a Heading 3, the position as a Heading 4, the company or school as a Heading 5, and a description.

progress_bar

[progress_bar text="Photoshop" percent="90"]


text="" ... The name of the skill.
percent="" ... 1-100. The length of the bar.

service

[service]
<img src="" alt="">
<h4>COPYWRITER</h4>
Description of the service.
[/service]

An image, a title as a Heading 4, and a description. On the "about me" page of the demo, each service is in a column of a row.

testimonial

[testimonial]
<img src="" alt="">
<h4>Name</h4>
<h5>Job</h5>
Text of the testimonial.
[/testimonial]

fun_fact, process

[fun_fact]
[icon name="pe-7s-coffee"]
<h4>1,250 Cups of Coffee</h4>
[/fun_fact]

[process]
[icon name="pe-7s-light"]
<h4>Idea</h4>
[/process]

An icon with a short text as a Heading 4, in two styles. The "contact" page of the demo uses fun_fact for the contact details.

client

[client]
<img src="" alt="">
[/client]

The logo of a client.

tabs_wrap, tab_pane

[tabs_wrap titles="Design,Code" active="Design"]
[tab_pane]Content of the first tab.[/tab_pane]
[tab_pane]Content of the second tab.[/tab_pane]
[/tabs_wrap]


titles="" ... The titles of the tabs, separated by commas.
active="" ... The title of the tab that is open first.

accordion, toggle

[accordion first_accordion="yes" active="yes" title="Title"]Content here.[/accordion]
[accordion title="Title"]Content here.[/accordion]
[accordion last_accordion="yes" title="Title"]Content here.[/accordion]

[toggle first_toggle="yes" title="Title"]Content here.[/toggle]
[toggle last_toggle="yes" title="Title"]Content here.[/toggle]


first_accordion="yes", first_toggle="yes" ... For the first item of the group.
last_accordion="yes", last_toggle="yes" ... For the last item of the group. A group of one item has both.
active="yes" ... (optional) The item is open when the page loads.

In an accordion, only one item is open at a time. Toggles open and close independently.

button

[button text="DOWNLOAD CV" url="" new_tab="" size="" icon=""]


url="" ... The address the button opens.
new_tab="" ... (optional) yes opens the address in a new tab.
size="" ... (optional) small, medium or big.
icon="" ... (optional) The name of an icon, like pe-7s-download (see Icons below).

alert

[alert type="success"]Text here.[/alert]


type="" ... standard, success or error.

icon

[icon name="pe-7s-coffee"]


name="" ... The name of an icon (see Icons below).

quote

[quote name="Steve Jobs"]Design is not just what it looks like and feels like. Design is how it works.[/quote]


name="" ... The name of the person.

social_icon

[social_icon first_icon="yes" type="facebook" url="https://www.facebook.com/username"]
[social_icon type="instagram" url="https://www.instagram.com/username"]
[social_icon last_icon="yes" type="twitter" url="https://x.com/username"]


first_icon="yes" ... For the first icon of the group.
last_icon="yes" ... For the last icon of the group. A group of one icon has both.
url="" ... The address of your profile. For the rss icon, use the feed address of your site, like https://www.yoursite.com/feed/
type="" ...

behance, blogger, delicious, digg, dribbble, facebook,
fivehundredpx, flickr, forrst, foursquare, friendfeed, github,
google-plus, imdb, instagram, lastfm, linkedin, picasa,
pinterest, rss, skype, slideshare, snapchat, soundcloud,
spotify, stack-overflow, tumblr, twitter (X), vimeo, vine,
vkontakte, weibo, wordpress, xing, youtube

Use them on a page, or in a "Custom HTML" widget in the "Footer Social Icons" widget area (see the Sidebar section).

contact_form, map

[contact_form to="yourname@example.com" subject="Contact form message"]

[map latitude="-25.363882" longitude="131.044922" zoom="5" image=""]

See Contact Page for their options, the Google Maps API key and how the messages are sent.

rotate_words

<h4>I am [rotate_words titles="a writer.,a blogger.,an adventurer."]</h4>


titles="" ... The words, separated by commas.

Types the words one after another, like on the "home" page of the demo.

mini_text

[mini_text]Text here.[/mini_text]

Shows a text in a narrower column, for example in a Standard portfolio item (see the Portfolio section).

Icons

The theme uses the Pe-icon-7-stroke icon font. Use the name of an icon in the icon shortcode, in the icon="" of a button, and in the "Icon" field of the page widgets (see Page Widgets). These are all the icons; type in the box to find one:

202 icons
pe-7s-add-user
pe-7s-airplay
pe-7s-alarm
pe-7s-album
pe-7s-albums
pe-7s-anchor
pe-7s-angle-down
pe-7s-angle-down-circle
pe-7s-angle-left
pe-7s-angle-left-circle
pe-7s-angle-right
pe-7s-angle-right-circle
pe-7s-angle-up
pe-7s-angle-up-circle
pe-7s-arc
pe-7s-attention
pe-7s-back
pe-7s-back-2
pe-7s-ball
pe-7s-bandaid
pe-7s-battery
pe-7s-bell
pe-7s-bicycle
pe-7s-bluetooth
pe-7s-bookmarks
pe-7s-bottom-arrow
pe-7s-box1
pe-7s-box2
pe-7s-browser
pe-7s-calculator
pe-7s-call
pe-7s-camera
pe-7s-car
pe-7s-cart
pe-7s-cash
pe-7s-chat
pe-7s-check
pe-7s-clock
pe-7s-close
pe-7s-close-circle
pe-7s-cloud
pe-7s-cloud-download
pe-7s-cloud-upload
pe-7s-coffee
pe-7s-comment
pe-7s-compass
pe-7s-config
pe-7s-copy-file
pe-7s-credit
pe-7s-crop
pe-7s-culture
pe-7s-cup
pe-7s-date
pe-7s-delete-user
pe-7s-diamond
pe-7s-disk
pe-7s-diskette
pe-7s-display1
pe-7s-display2
pe-7s-door-lock
pe-7s-download
pe-7s-drawer
pe-7s-drop
pe-7s-edit
pe-7s-exapnd2
pe-7s-expand1
pe-7s-eyedropper
pe-7s-female
pe-7s-file
pe-7s-film
pe-7s-filter
pe-7s-flag
pe-7s-folder
pe-7s-gift
pe-7s-glasses
pe-7s-gleam
pe-7s-global
pe-7s-graph
pe-7s-graph1
pe-7s-graph2
pe-7s-graph3
pe-7s-gym
pe-7s-hammer
pe-7s-headphones
pe-7s-helm
pe-7s-help1
pe-7s-help2
pe-7s-home
pe-7s-hourglass
pe-7s-id
pe-7s-info
pe-7s-joy
pe-7s-junk
pe-7s-key
pe-7s-keypad
pe-7s-leaf
pe-7s-left-arrow
pe-7s-less
pe-7s-light
pe-7s-like
pe-7s-like2
pe-7s-link
pe-7s-lintern
pe-7s-lock
pe-7s-look
pe-7s-loop
pe-7s-magic-wand
pe-7s-magnet
pe-7s-mail
pe-7s-mail-open
pe-7s-mail-open-file
pe-7s-male
pe-7s-map
pe-7s-map-2
pe-7s-map-marker
pe-7s-medal
pe-7s-menu
pe-7s-micro
pe-7s-monitor
pe-7s-moon
pe-7s-more
pe-7s-mouse
pe-7s-music
pe-7s-musiclist
pe-7s-mute
pe-7s-network
pe-7s-news-paper
pe-7s-next
pe-7s-next-2
pe-7s-note
pe-7s-note2
pe-7s-notebook
pe-7s-paint
pe-7s-paint-bucket
pe-7s-paper-plane
pe-7s-paperclip
pe-7s-pen
pe-7s-pendrive
pe-7s-phone
pe-7s-photo
pe-7s-photo-gallery
pe-7s-piggy
pe-7s-pin
pe-7s-plane
pe-7s-play
pe-7s-plug
pe-7s-plugin
pe-7s-plus
pe-7s-portfolio
pe-7s-power
pe-7s-prev
pe-7s-print
pe-7s-radio
pe-7s-refresh
pe-7s-refresh-2
pe-7s-refresh-cloud
pe-7s-repeat
pe-7s-ribbon
pe-7s-right-arrow
pe-7s-rocket
pe-7s-safe
pe-7s-science
pe-7s-scissors
pe-7s-search
pe-7s-server
pe-7s-settings
pe-7s-share
pe-7s-shield
pe-7s-shopbag
pe-7s-shuffle
pe-7s-signal
pe-7s-smile
pe-7s-speaker
pe-7s-star
pe-7s-stopwatch
pe-7s-study
pe-7s-sun
pe-7s-switch
pe-7s-target
pe-7s-ticket
pe-7s-timer
pe-7s-tools
pe-7s-trash
pe-7s-umbrella
pe-7s-unlock
pe-7s-up-arrow
pe-7s-upload
pe-7s-usb
pe-7s-user
pe-7s-user-female
pe-7s-users
pe-7s-vector
pe-7s-video
pe-7s-voicemail
pe-7s-volume
pe-7s-volume1
pe-7s-volume2
pe-7s-wallet
pe-7s-way
pe-7s-wine
pe-7s-world
pe-7s-wristwatch

Translate the Theme

All texts of the theme are translatable. You can translate them into your language with a plugin (Loco Translate) or with a desktop editor (Poedit).

The theme includes a template file that contains all of its texts: empathy.pot, in the "languages" folder of the theme. You can also use translation to change the theme's English texts. For example, category archives show the title Category. You can create an "English (United States)" translation and change this title to something like Posts in Category.

Important: Don't save your translation files in the theme folder. Theme updates replace the whole theme folder, so your translations would be deleted. Save them in one of the folders described below, which theme updates don't touch.

With Loco Translate (Recommended)

  • Install and activate the Loco Translate plugin.
  • Go to Loco Translate > Themes and select Empathy.
  • Click "New language" and choose your language.
  • For the location, choose "Custom" (wp-content/languages/loco/themes/). If you don't see this option, create that folder first.
  • Click "Start translating", translate the texts, and click "Save".

With Poedit

  • Open the empathy.pot file in Poedit, create a new translation for your language, and translate the texts.
  • Save the translation. Poedit saves a .po file and also creates a .mo file, which is the file WordPress uses.
  • Name the files with the theme name and your language code, like empathy-de_DE.po and empathy-de_DE.mo for German. Then upload them to the "wp-content/languages/themes/" folder.

Set Your Site Language

Go to Settings > General and choose your language in "Site Language". Your translation appears on the site only when the site language matches it.

Plugin Texts

The labels of the portfolio in your dashboard, like "Portfolio Categories" and the options of the "Type" box, come from the Pixelwars Portfolio plugin. To translate or change them, follow the same steps under Loco Translate > Plugins > Pixelwars Portfolio.

Multilingual Sites

To publish your content (posts, pages, and menus) in more than one language, use a multilingual plugin. For the theme's own texts, most of these plugins use the theme's translation files, so translate the theme first as described above.

A backup is a copy of your site that you can go back to if something goes wrong, like a failed update, a broken plugin or a hacked site. Keep recent backups, and keep at least one copy outside your server.

What to Back Up

A full backup has two parts. You need both to restore your site:

  • Files: Your WordPress files, especially the "wp-content" folder (themes, plugins and uploaded images) and the "wp-config.php" file.
  • Database: Your posts, pages, comments, menus, widgets and settings, including the Customizer settings.

When to Back Up

  • Before you update the theme, plugins or WordPress (see the Update section).
  • Before you import the demo content into a site that already has content (see the Demo Import section).
  • Before big changes, like switching to another theme or editing the theme's files.
  • Regularly: daily or weekly, depending on how often your site changes.

How to Back Up

  • Hosting backups: Many hosting providers back up your site automatically. Check your hosting control panel or ask your hosting provider how often they back up and how long they keep the backups.
  • Backup plugin: The free UpdraftPlus plugin backs up your files and database on a schedule. It can also send the backups to cloud storage like Google Drive or Dropbox.

Keep copies outside your server (in cloud storage or on your computer), so you can restore your site even if your server has a problem. See WordPress Backups to learn more.

Restore a Backup

Restore your site with the same tool you used to back it up. In UpdraftPlus, go to Settings > UpdraftPlus Backups, find the backup in the list of existing backups and click "Restore". For hosting backups, use your hosting control panel or ask your hosting provider.

Note: From time to time, check that your backups work, for example by restoring one on a test site.

Before You Update

  • Back up your site: Make a full backup of your site (files and database) before you update. See the Backups section.
  • Translations: An update replaces the whole theme folder. If you saved translation files in the theme's "languages" folder, back them up first, because the update deletes them. To avoid this, keep your translations outside the theme folder: Loco Translate can save them in a protected folder (wp-content/languages/loco/) that theme updates don't touch. See the Translation section.
  • Code changes: Changes made directly in the theme files are lost when you update. Make your code changes in the child theme instead (see the Installation section). If you use the child theme, update only the parent theme. The child theme stays as it is.

Update Your Theme

Choose one of the following ways. With the Envato Market plugin, you don't need to download anything. For the other two ways, download the new theme package from your ThemeForest account and unzip it. The theme file to upload (empathy.zip) is inside the "Theme/1 - Parent Theme" folder of the package, in the folder with the new version number.

Note: The "Theme/1 - Parent Theme" folder also has a "Previous Version" folder, with the ZIP file of the previous theme version. If your site has a problem after an update, you can go back to the previous version: install this file the same way, via WordPress or via FTP.

Update Your Theme via Envato Market Plugin

The Envato Market plugin connects your site to your ThemeForest account. WordPress can then check for updates of the themes you purchased and install them.

  • The plugin isn't available on WordPress.org. Download it from the Envato Market page, then install it from Plugins > Add Plugin > Upload Plugin.
  • Go to the "Envato Market" page in your dashboard and connect the plugin to your account with a personal token. The page shows you how to create one.
  • When a new version is available, update the theme from the "Envato Market" page or from Dashboard > Updates.

Update Your Theme via WordPress

  • Go to Appearance > Themes > Add Theme > Upload Theme.
  • Click "Choose File", select the new empathy.zip file, and click "Install Now".
  • WordPress sees that the theme is already installed and shows the current and the uploaded versions. Click "Replace installed with uploaded".

You don't need to activate another theme or delete the current one first. Switching to another theme and back can mix up your menu locations and widgets.

Note: If your host doesn't allow uploading large files, update the theme via FTP.

Update Your Theme via FTP

You can upload files to your site with an FTP client or with the file manager in your hosting control panel. See Updating WordPress using FTP to learn more about both.

  • Unzip the new empathy.zip file on your computer to get the new "empathy" theme folder.
  • Upload the new theme folder into "/wp-content/themes/" with a temporary name, like "empathy-new".
  • Rename the current "empathy" folder to "empathy-old", then rename "empathy-new" to "empathy".
  • Check your site. If everything works, delete the "empathy-old" folder.

Note: Don't upload the new folder over the old one. Files that were removed in the new version would stay on your server.

Update Theme Plugins

The theme comes with the Pixelwars Portfolio plugin. A new theme version can include a new version of it, so update it right after you update the theme: go to Appearance > Install Theme Plugins and update it there. WordPress also shows a notice in the dashboard when it needs an update. The other plugins the theme recommends (see the Plugins section) come from WordPress.org, so you can update them like your other plugins, in Dashboard > Updates or on the Plugins page.

Update WordPress

Keep WordPress up to date, because new versions include security fixes (see the Security section). Before you update to a new major version of WordPress, make a backup and check whether a theme update for the new version is available. You can find your theme's page on ThemeForest in the Pixelwars portfolio.

If you prefer to start major updates yourself, go to Dashboard > Updates and click "Switch to automatic updates for maintenance and security releases only". Maintenance and security releases will still be installed automatically. Don't postpone major updates for long.

Security Recommendations

Using a WordPress site securely is essential for protecting your website from potential threats. Here are some key security recommendations:

Keep WordPress, Themes & Plugins Updated

Always keep WordPress, themes, and plugins updated to the latest versions to prevent security vulnerabilities. See the Update section to learn how to update the theme.

Download Themes & Plugins From Official Sources Only

Download the theme and its updates only from your ThemeForest account or through the Envato Market plugin (see the Update section). Download plugins only from WordPress.org or from their developers' websites. Never use "nulled" (pirated) copies of themes or plugins: they often contain hidden malicious code that can give attackers control of your site.

Remove Unused Themes & Plugins

Delete the themes and plugins you don't use. Deactivated themes and plugins still stay on your server, and a security flaw in them can still put your site at risk. Don't delete the parent theme if you use its child theme, and keep one default WordPress theme (like Twenty Twenty-Five) as a fallback.

Keep PHP Up to Date

WordPress runs on PHP, and old PHP versions no longer receive security fixes. You can see your PHP version under Tools > Site Health > Info > Server. If it is no longer a supported version, ask your hosting provider to switch to a newer one. Before switching, update WordPress, your theme, and your plugins.

Avoid the "admin" Username

Don't use "admin" or other easy-to-guess usernames. WordPress doesn't let you change a username, so if your site has an "admin" account, create a new administrator account with a unique username, log in with it, and delete the old account. When WordPress asks what should be done with the content owned by that user, choose "Attribute all content to another user" and select your new account. Otherwise, all posts and pages of the old account will be deleted.

Use Strong Passwords

Ensure that you use complex passwords for your admin panel, database, and hosting account. Consider using a password manager. Don't re-use the same password on different services, especially if you are using the same username.

Use SSL Certificate (HTTPS)

Ensure your website uses HTTPS with an SSL certificate. Most hosting providers offer free SSL via Let's Encrypt. Once your site opens with https://, go to Settings > General and change both "WordPress Address (URL)" and "Site Address (URL)" to start with https://. See HTTPS for WordPress for more details.

Install a Security Plugin

Use a security plugin like Wordfence, Kadence Security (formerly iThemes Security), or Sucuri Security to add extra protection layers. Important: If you decide to use a security plugin, make sure to activate only one at a time. Running multiple security plugins simultaneously may cause conflicts and errors.

Enable Two-Factor Authentication (2FA)

For additional security, enable 2FA for your WordPress login to prevent unauthorized access. With 2FA, you enter a one-time code from an app on your phone after your password. WordPress doesn't include 2FA by default. Wordfence and Kadence Security include this feature. If you don't use one of them, you can use the Two Factor plugin.

Backup Your Website Regularly

Use a backup plugin like UpdraftPlus or your hosting provider's backup service to prevent data loss (see the Backups section).

By following these security measures, you can significantly reduce the risk of attacks and keep your WordPress site safe.