NOTICE: This Doc is for Art WordPress Theme version 2 only, plase click here to check Doc for version 3

Important Notice:
WordPress 5.0.x UPDATE (learn more)

Art. WordPress Theme Documentation

Thank you for purchasing our theme. If you have any questions that are beyond the scope of this help file, please feel free to publish your question here.
Thanks so much!

To help us with theme FREE updates with new features please take 1 min to leave stars rating for this theme on ThemeForest if you like it, we'll appreciate it:

  1. Please go to Themeforest login and navigate to your account.
  2. Click Downloads link and you will see your purchases list:


  3. Click stars around our theme to leave stars rating:


  4. Thanks! This little thing will help us to release new theme updates!
  5. If you don't like something in our theme or have some problems, please contact us and we will fix your issue and will help you! We are always welcome for your advices how to improve our theme.

Because the BM Content Buidler plugin and page/post option will not work with block editor for now. We disable the block editor of WordPress 5.0.x by default. If you want use the block editor, please install/activate the Classic Editor plugin(Appearance > Install Plugins).


To use a WordPress theme you must have a working version of WordPress already installed. For information in regard to installing the WordPress platform, please refer to the WordPress Codex here

Video Guide:

  1. Extract the package file
  2. After extract the main zip file, you'll see these folders and files:

    • - Art theme installable file
    • documentation folder - help file
    • - Child theme installable file
    • plugins folder - The plugins install file
    • log folder
  3. Install theme file
  4. This template works well for WordPress 4.9.x, update yours if needed.
    Installing the theme can be done in 3 ways. You can upload the theme ZIP file using the built in WordPress theme upload, or copy the files through an FTP client.

    • Using WordPress Theme Upload:

      Be sure to extract the file "" from the ThemeForest download before uploading. Using the ThemeForest ZIP file directly will result in a "Missing Style Sheet" error.
      • Login to your WordPress admin.
      • In the "Appearance > Themes" menu click tab "Install Themes".
      • At the top of the page click "Upload", then click "Choose File".
      • Select the zipped theme file, "", and click "Install Now".
      • After installation you will receive a success message confirming your new install.
      • Click "Activate".
    • Using FTP:
      • Login to your FTP server and navigate to your WordPress themes directory.
      • Normally this would be "wp-content/themes".
      • Extract folder "art-theme" from the zipped theme.
      • Copy the folder "art-theme" to your themes directory.
      • After the files finish uploading, login to your WordPress admin.
      • In the "Appearance" menu click "Themes".
      • Click "Activate" for the theme "Art Lightweight Portfolio WordPress Theme".
  5. Plugins Installation

    After activating the theme, you would notice the message box on the top of admin pages to ask you install/activate some plugins, you could use them for free or cancel the messages. Include: BM Content Builder(must install), BM Slider, BM Tools, WooCommerce, WP Google Maps, Loco Translate, SVG Support ...


    • Click Begin installing plugins in this message.
    • You could check all required plugins, they are optional. You could install/activate what you need:


    Note: Please install/activate the BM Builder and BM Slider plugin before import demo data.
    Not all plugins are necessary. If you don't need maps, you will not insltall Google Maps.

  6. Import Demo Data
    • Install/activate the BM Builder, BM Slider and BM Tools plugin.
    • Go to BM Tools > Import, select "Art Theme Demo".

      choose the demo file

    • The "Import Origin Images" is optional, it will download all images from demo website if it is activated.
    • Click "Import Data"
  7. How to update the theme? (click)

  1. Globle settings: in Appearance > Theme Option panel, you could set the whole website general settings, such as logo, header style, main container , font and colour, e.g.
    1. To set colours, please go to Appearance > Theme Option > Colors (or Appearance > Customize > Colors). You could also set font and colour for individual module built by BM Content Builder
  2. Define the fonts. Click here.

  3. To create the main content:
    • To create a single project, please go to Portfolio > Add New. Please make sure that the BM Content Builder plugin is actived.
    • To create a page(like portfolio list, blog list, about...), please go to Page > Add New, we strongly suggest you create the content by BM Content Builder.
    • To create a blog post, please go to Posts > Add New

To set up logo for your website, you need to:

  1. Go to the WordPress Admin Dashboard.
  2. Go to "Appearance > Theme Options" (on left sidebar).
  3. Go to Theme Options > General Settings > Logo section, here you could upload a logo image or input logo text.

The default container for custom logo is 240px(width) * 120px(height), it is the container size. If you want the logo be displayed clearly on retina screens, you need to upload a double size image logo(e.g. 480px x 320px).
Use "Custom Logo Height" to forse the logo size.

3. Frontpage

To set up the homepage, you need to create a page which you want to use it as homepage, after that, go to Settings > Reading , activate A static page (select below) , select the page from Front page: drop-down menu.

set frontpage

Before building your custom menu, you need to create your pages first, then navigate to Appearance > Menus, it is recommended to create you menu from Pages or Links.

5. Theme Custom

On admin panel the left hand, click "Appearance > Theme Options" to enter Theme Options

From Theme Options, you could:

To setup the fonts for your website, please go to Fonts Management > Fonts Definition from the admin panel. (If there is not the "Fonts Management" item, please check if the "BM Content Builder" plugin has been installed and activated).

Fonts Management

You should define the fonts firstly, there are 4 kinds of source: Google Fonts, Adobe Typekit, Uploaded Fonts and System Fonts.

Fonts Management

Go to Fonts Management > Fonts Assignment to assign the font to webpage elements.

Fonts Management

Check the video guide:

To create a new single portfolio(project), go to Portfolio > Add New from the admin panel. (If there is not the "Portfolio" item, please check if the "BM Content Builder" plugin has been installed and activated)

Portfolio/add new

Each portfolio should be assigned one category at least. You could set category to organize the portfolios. For the "Portfolio Grid" or "Portfolio Masonry Grid" module in BM Builder, it would list the portfolio come from the category you have choosed.


You could set "Featrued Image" for posts, the featured image could be shown in portfolio list("Portfolio Grid" or "Portfolio Masonry Grid" module):

Post in List/Featured Image

You could set "Cover Image" for single portfolio hero image.

Single Portfolio Cover Image

To create a new post, go to Posts > Add New from the admin panel. (refer to this article)

Post/add new

7 Post Formats

The theme provide 7 formats for your post, theses formats would affect the layout of your post in list and content page. You need the to click the radio button to change the format for a post:

Post Formats

Go to Pages / Add New, you could build all kind of pages.

Page/add new

You'll see the BM Content Builder button:

Activate BM Content Builder

If the button is not visalbe, please insall and activte the BM Content Builder plugin(refer). Press the button, you'll see the interface of builder. It is inclued 2 parts: settings(left bar) and main content builder(main content).

BM Content Builder Main Interface


Click "Settings", you'll see the page options:

Template Settings

Hero Section

It could be set None, Fullwidth Slider or Cover Image.

BM Content Builder Main Interface

  • The BM Slider and Revlution Slider could be set for the Fullwidth Slider:

    Choose Slider

  • The Featured Image will be shown for the Cover Image. There is the height and scrolled effect options:

    Cover Image


It could be shown/hidden.

Header & Footer

The header and footer could be shown/hidden.

Header Footer

  • If "Content From Top" activated, the header will be covered above the content.

    Content From Top

  • Enter a vaule(number) into "Header Bottom Spacing", there will be a gap at bottom of header:

    Header Bottom Spacing

  • Set Dark or Light for The "Header Text Color".

    Header Text Color

    1) Set the dark and light color value here: Appearance > Theme Options > Color: Plain Text Logo, Menu.
    2) If you use image logo, you need upload both dark and light images.
    3) Set the default color skin here: Appearance > Theme Options > Color: Others / Logo & Menu Skin on Header.
    4) If you both use "BM Slider" and activate "Content From Top", the "header text color" based on image color of each slide item.

  • The page could be set "Background" and "Font" color.

    Background Color

Note: If you change any options in "Settings", you need click "update".


Content Builder

There are 7 modules within the builder: Text, Button, Grid, Custom Grid, Single Image, Button, Content Form and Embed.


Click to add a new module, like Text, the pop-up panle will be shown:


Move the mouse cursor over the "Spacing", you could enter a number for the "Top Spacing(desktop and mobile)" / "Bottom Spacing(desktop and mobile)" of this module.

Enter some text, click "Save", you'll see the real content in the preview area, because the builder is a live editor, you'll see the content what you edit. Move the mouse cursor over the module, there is a tools bar shown.

Tools bar

Click "+" / "-" to increase / reduce the columns. Each module could be set 1-12 cols width. When the module is 12 cols already, click "+", the module will be fullwidth.

Click "Pencil" button to edit a module:


You could set the "Offset" 1-12 cols for each module:


If you move the mouse cursor to the page blank(at the bottom of existed module), the modules bar will be shown:

Module add bar

Check the video guide:


To show the content text or shortcodes, you could use the text module. You could set the "Background color" and "Inner Wrap Width" for the module. Enter the something into the editor.

Text module

There is 3rd party wysiwyg editor within the Text module. You could set the "Font color / background color", "Font Size / Line height / letter spacing", "Container Height" and other option with the editor. If you set "Container Height" as "Browser Height", the content in Text module would be vertical centering.

Font color / background color:

Font size:
Editor - Font size

Click this button if you you want the code mode:
Code mode

The text editor spport shortcode also, if you want to show a map, please use the WP Google Maps plugin. Add the map by Maps > Maps, Enter the shoertcode likes:
Code mode

There are Background color, image and video option for Text module.
You could create fullscreen wrap with color, image or video by "Text" module:

  • Add a "Text" module, click "Advanced settings", set "Color" "Image" or "Hosted video" for background.

  • Click "General settings", set "Container Height" as "Browser Height", click "Save".
  • Click "+" to set width as fullwidth.

Tips: If set "Hosted video" , suggest enter both mp4 and webm, will support most browsers.

Single Image

To show the one image, you could use the Single Image module.

Single Image module

There are "Style", "Algin", "Mouse effect" and "Lightbox" options.

Masonry Grid
To make a masonry grid list (like portfolio), you could use the masonry grid.

Masonry Grid

  • Sourse:
    • Media Library: You can choose the images of media library to create portfolio. Please check the video guide:

    • Portfolio: to show the single portfolio posts(Portfolio of left admin bar);
    • Post: to show the normal posts;
    • Woo-commerce Product: to show the product list, it needs to install/activate the Woocommerce plugin;

    If you choose scource as Portfolio, Post or Woo-commerce Product, you need Choose a Category. The single portoflio/post/product within this category will be shown. Each post should be set "Featured Image" for thumbnail.

    Pickup Category

    Please check the video guide:

  • Filter:
    If you want to show filter for the portfoli list, please enable the "Filter" option. Make sure there are sub-categories in the category of the portfolio list. The category structure looks like:

    category tree

    For "Media library" source, you could set category for each image, but don't set parent category, it will list all categories of level 1 set on images.

    You can set category for each image in Media > Library also.

    Image Category

  • What Thumbnail Does:
    • Open The Portfolio Item: when you click one item, the gallery post page would be linked. If this item is a Link format post, the first url set within link post would be linked.
    • Open Lightbox: when you click one item, the full size featured image will be opened in lightbox. If you enter embed video code into "Show Video" of single portfolio or video format post, the video will be shown in lighbox instead of featured image.
    • The "Open Custom URL" and "Nothing" are only for from "Media Library".

      Custom URL

  • Fit Image into Grid: The images are filled into grid by default(the images will be cropped). If it is activated, the images will be fit within the grid, the size of image will be limited in grid.
  • Image Lazyload: If it is activated, the images will only be loaded when they are on current screen. The page will be loaded faster.
The Grid module is most same as the Masonry Grid.
It can be set the standard grid like:

Grid Module

It can be set the masonry(waterfall style) list, set "Grid Ratio" as auto, set "Grid List Type" as "Masonry Grid".

Grid Module

It looks like:

Grid Module

Use the Gird module to create a blog page(Resourse: Post, Image Ratio: Auto, Grid List Type: Masonry Grid, Item Style: Image + Text):

Grid Module

Please check the video guide:

To show one or more buttons, you could use this module:

Button Module
Contact Form
To show contact form, you could use this module:

Button Module

1) if you can't receive the mail, please check your mail box, It maybe moved to the spam.
2) Try to use SMTP WP plugin, like

To enter a video to the page, you need to copy and paste the embeded code of the video, a example with Vimeo video:

Supported video:

  • Vimeo
  • Youtube
  • and other embeded videos from video sites

For Vimeo and Youtube video, you could directly copy/paste the link of the video:

Social Media

Social Media

Click to share this page by social media, it supports 10 icons

To create the hero section, please go to WordPress Admin Panel: BM Slider > Add New. If you can't see the menu item, please go to Appearance / Install Plugins to install BM Slider plugin(refer).

1. Tranlate Theme

You can translate the static strings to your language using Loco Translate WordPress plugin(check the DOC) or Poedit. There is the default pot file "art-theme.pot" in /languages/ folder.


It is recommend to use the popular WPML wp plugin if you want to make a multi-languages site:

2.1 Translate the Builder
  1. Created a new page(make sure under default language), activate builder editor, put in some modules, click publish
  2. Check ‘Duplicate’ checkbox and click “Duplicate” (see the screenshot below) at the right sidebar. “Duplicate” button will be displayed after checking of checkbox. Click the pencil icon to translate the page

    ZA WordPress theme - translate the Content Builder ZA WordPress theme - translate the Content Builder

2.2 To translate the copyright information, Comment title and so on, please:
  1. Install the plugin WPML String Translation.
  2. Go to left menu: WPML/String translation
  3. Find the following string:

  5. Click “translations” on the right side of every string item, enter the target translated words, check on “Translation is complete" and save it.
2.3 To set the language switcher
  1. Go to Appearance > Theme Options > Layout : choose the "WPML Switcher" for "Footer Elements", the swithcer will be shown on footer bar:

    Language Switcher

  2. Go to WPML > Languages, click "+ Add a new language switcher to a menu", the switcher could be shown in menu.
  1. Javascript files
    1. Bootstrap v3.3.5 - js/bootstrap.js - Bootstrap framework js
    2. Modernizr 3.5.0 - js/modernizr-custom.js - Respond user's browser features
    3. Waypoints v4.0.1 - js/jquery.waypoints.min.js - Trigger something scrolling a anchor
    4. Isotope v3.0.4 - js/isotope.pkgd.min.js - Masonry layout plugin
    5. - js/packery-mode.pkgd.min.js - PACKAGED v2.0.0 - For Isotope packery layout
    6. - js/photoswipe.min.js - PhotoSwipe v4.1.2 - Lightbox plugin
    7. ImagesLoaded v4.1.2 - js/imagesloaded.pkgd.min.js - Judge images loaded or not
    8. OwlCarousel v2.2.1 - js/owl.carousel.min.js - Slider plugin
    9. LazyLoadXT v1.1.0 -/js/jquery.lazyloadxt.min.js - Image lazy load plugin
    10. VelocityJS v1.5.0 - js/velocity.min.js - Animation effect
    11. jPlayer v2.9.2 - js/jquery.jplayer.min.js - HTML5 media player plugin
    12. ie.js - js/ie.js - For IE browser
    13. custom.theme.js - js/custom.theme.js - Art theme main js
  2. CSS files
    1. Bootstrap v3.3.5 - styles/bootstrap.css - Bootstrap framework
    2. OwlCarousel2 css - styles/owl.carousel.css - Slider plugin css
    3. photoswipe - styles/photoswipe.css, styles/skin/photoswipe - Lightbox plugin css
    4. style.css - style.css - theme main css
    5. style.css - rtl.css - theme RTL css

Once again, thank you for purchasing my theme. If you have any questions that are beyond the scope of this help file, please feel free to publish your question here.