Documentation & Guide
To install Berry theme, first you need a self-hosted WordPress site. Click the link below to go to WordPress download page, there you will find useful information about installing WordPress.
If you are new to WordPress, we recommend reading some articles about basic knowledge of WordPress before you get started. WordPress is a powerful system with a lot of features, knowing some basics about it will help you to manage your site easily.
Here are some detailed WordPress beginner tutorials that we find useful:
To use Berry theme, please make sure your server meets the following requirements:
If you encounter any issue listed below, it is related to low PHP configuration limits:
The solution is to increase those PHP configuration limits. Please log into your hosting cPanel and change them. Or you can try to contact your hosting provider and ask them to increase those limits to a minimum as follows:
We assume that you already have a running WordPress site. Now let's install Berry.
You need to download the theme zip file from ThemeForest first. Go to Downloads on ThemeForest, and find Berry. Download the files and find berry.zip - that's what you need for installation.
Please do not upload the zip file of the entire package (which contains "All files and documentation") for installation. Or you will see "The package could not be installed. The theme is missing the style.css stylesheet" error message. If you see this error message, please unzip the file you tried to upload and then find "berry.zip" file in it.
Here is an article you may like to read: Theme is missing the style.css stylesheet error.
Please note: If you are going to write custom code for the theme, then please also upload the berry-child.zip file (you will find it in the folder "WordPress Child Theme" in your download package), then install and activate the child theme. Then you can change code or write your own custom styles for the theme in the child theme files. Later when you need to update the theme, just update berry.zip (the parent theme), so your custom code changes will not be overwritten (because they are all in the child theme).
As mentioned above, when installing & activating Berry theme, you will see the notice "This theme requires the following plugin: Berry Extension". It is the Berry Theme function extensions - including these features: post like, post sharing, gallery slider, Instagram feed and more.
Why do you need to install the required plugin?
Because of WordPress code standards and ThemeForest requirements: "Themes execute the presentation and styling of content, while plugins handle content creation and functionality." Therefore, some features must be included in the required plugin but not included in the theme itself.
Please note: Before version 1.3, the required plugin "Berry Extension" was activated automatically after installation. But since version 1.3, we cancelled the auto-activation because of the latest Envato WordPress theme requirements.
Therefore, after installing/updating the plugin, please always make sure the plugin is activated.
If you need to find "Berry Extension" zip file, please:
As mentioned above, when installing & activating Berry theme, you will see the notice "This theme recommends the following plugins…". Those plugins are not required to use the theme, but will extend the theme basic functionality. All those plugins are hosted on the official WordPress repository and are made by other authors. You don't need to install and activate all of them, just choose those you will use on your site.
The recommended plugins are:
When updating Berry theme, please follow the following 2 steps:
We recommend Envato Market plugin. It can install WordPress themes and plugins purchased from ThemeForest & CodeCanyon by connecting with the Envato Market API using a secure OAuth personal token. Once your themes & plugins are installed WordPress will periodically check for updates, so keeping your items up to date is as simple as a few clicks.
You will see this note while installing Berry theme, please click it to install and activate Envato Market plugin.
Then go to Envato Market > Settings, click on the link to generate a personal token, and then insert it below, then save changes.
When generating your personal token, please use the same Envato account you used when purchased the theme, and make sure you have checked the following 3 permission options:
There will show new tabs: Themes & Plugins (if you have purchased both themes & plugins from Envato).
As you can see in the screenshot below: if there is a newer version for a theme or a plugin, it will show the notice, and you can update the item by clicking on the link Update Available.
Please follow steps below when you need to update Berry theme manually on your site:
When update Berry theme, if you also see this note, please click on "Begin updating plugin" link to update the Berry Extension plugin as well.
Reactivate the Required Plugin - Please make sure to reactivate Berry Extension plugin after updating. If the required plugin is not activated, some features will not be available.
You may like to read this how-to article for more details.
To import the demo content, please make sure you have installed the recommended plugin One Click Demo Import while installing Berry theme.
After installing Berry and required/recommended plugins, refresh the page, you will see Import Demo Data under Appearance in the left sidebar. Click it, then you will see 9 demos' screenshots. Choose one demo, click on the Import button. It can take a couple of minutes, please wait.
Please note: Don't import multiple demos to the same site, it will create duplicate data.
When importing finished, please follow the steps below:
It happens rarely, but if you have issues while importing a demo, please check the documentation Import Issues written by the author of the plugin One Click Demo Import (which we are using for demo importing feature in Berry theme).
If you see this error message after clicking on import button, this usually indicates a poor server configuration, usually on a cheap shared hosting (low values for PHP settings, missing PHP modules, and so on). Please see this article to know how to fix it.
If you don't want to import everything of a demo, you can choose any one of them and import manually. Demo files are located in the Berry theme folder > inc > ocdi.
In the ocdi folder, find these 2 folders: Content Default & Content Strawberry. Open either of the folders, there is the file "demo-content.xml" in it. It is the content data file.
On your site dashboard, please go to Tools > Import, choose WordPress and install it.
After installing, click on "Run Importer", choose "demo-content.xml" in one of those 2 folders, upload and import.
In the ocdi folder, find these 2 folders: Content Default & Content Strawberry. Open either of the folders, there is the file "widgets.wie" in it. It is the widgets data file.
Please install this free plugin: Widget Importer & Exporter. Install and activate this plugin, then go to Tools > Widget Importer & Exporter, choose "widgets.wie" in one of those 2 folders, upload and import.
In the ocdi folder, you can see the 9 folders: default-1, default-2, ... , strawberry-1, strawberry-2, ...
Open any one of those folders, you can find the file "customization.dat" in it, that's the customizer data of that demo.
Please install this free plugin: Customizer Export/Import. Install and activate this plugin, then go to Appearance > Customize > Export/Import > Import, choose "customization.dat", upload and import.
Berry theme supports WooCommerce since v1.2. You can sell products on your own site with Berry theme and WooCommerce plugin.
Upon installation, WooCommerce creates the following 4 new pages via its Onboarding Wizard:
To set up the shop page, on your site dashboard, please go to WooCommerce > Settings > Products tab > Display tab, there you can find the option Shop Page, select what page you want to be the default shop page (you can choose the shop page created by WooCommerce, or create a new page and choose it). Please check WooCommerce official documentation Configuring WooCommerce Settings about this part.
Right after installing WooCommerce you may find you have an empty store. There are no products, orders, reviews, and more by default. You can start to create your own products, or perhaps you’d like to see what sample orders and products look like, then you can choose to import some dummy content. Please check this article Importing WooCommerce Dummy Data to know details.
After you have set up your online store and created some products, you can tweak the layout of the shop index page and single product page via WordPress customizer. Please read the sub chapter Theme Customizer > Shop of Berry documentation to find out more.
Go to Appearance > Customize, there you can customise and personalise your theme layout and styles.
You will find the following options in this section:
In this section you can set general options for your site.
In this section you can choose nav bar style, show or hide elements in site header.
In this section you can choose to show or hide elements in site footer, and set its layout.
In this section you can change element’s color/background color/border color of your site.
The settings in this sub section will work globally.
In this section you can control the layout and posts style for the blog/posts page of your site. If your site homepage displays your latest posts, then your homepage is the blog/posts page, so you can also customize your homepage here.
Please open your customizer and navigate to Blog Page > Page Layout. You can select a page template for your blog page. There are 3 options:
Check to show a slider of some posts at the top of the post archive. And more options for it will show:
Since v1.2.8, users can display a custom hero image instead of the Featured Slider.
In customizer, please go to Blog Page > Featured Slider Alternative. Enable the option, choose A simple hero image from the dropdown list, then upload your custom hero image.
Please note: when enable "Featured Slider Alternative", the Featured Slider created by Berry theme will be removed from your blog/home page.
Since v1.2.8, users can display a custom slider created by a third-party plugin instead of the Featured Slider created by Berry theme.
Please note: when enable "Featured Slider Alternative", the Featured Slider created by Berry theme will be removed from your blog/home page.
Why use a third-party plugin for creating a custom slider?
WordPress theme controls over the look and presentation of the material on your website, plugin extends your site functionality. Although Berry theme also provides some extra functionalities, but there already are many great plugins for creating sliders. They are powerful and flexible, some are maintained well by their authors.
It's better to provide a simple and convenient interface to support those third-party plugins than to create our own built-in custom sliders feature from scratch.
Please also note: Usually those third-party plugins provide design options so Berry theme doesn't contain any style for those plugins.
Featured Boxes section is a new feature since version 1.1.3. Here you can upload background image for each box, then enter box title and link to each one.
Here you can control the latest post archive layout.
In this section you can set the layout and style of the 4 types of archive pages:
Just like Blog Page, you can choose the page layout and archive layout. And there is another option "Show all posts on one page", check it to ignore "show at most x posts" setting and list all posts of this archive on one page.
And the Hide categories option is available since v1.2.5, so you can choose to show or hide posts' categories meta on specific archive pages.
For example, to change the category archive pages' layout, please go to Customizer > Archive Pages > Category, there you can choose page layout, posts layout, and more.
Since v1.2.4, you can choose to show subcategories instead of posts on parent category page.
In the Customizer, go to Archive Pages > Category, you will see the option at the bottom of the panel:
In this section you can control single post default template, and show or hide some elements on single post.
In this section you will be able to style your WooCommerce shop pages (New feature since v1.2).
Please open the customizer and navigate to "Typography". In this section you will be able to set font options for text, such as Font Family, Content Font Size, Font Weight, etc.. Please read the following content for more information.
Options in this sub section will work for the whole site. You can choose 2 different fonts for different types of text. All 800+ Google Fonts are included in the drop down lists.
You can visit the site of Google Fonts to view the style of each font, then go back to the customizer of your website and select the font you like from the font list.
In this sub section you can tweak page/post content text style for Heading Text and Content Text separately.
In this sub section you are going to set font style for single page/post title, and posts title on blog/posts page and archive pages. Options including:
Sometimes you might like to add some custom CSS to your site to personalize some elements' styles. In the customizer, please locate to Additional CSS sub section and add your custom CSS code. Like the example showing in the screenshot below:
This is a default feature of WordPress since WordPress v4.7. If you can’t find Additional CSS sub section in your customizer, then it means your WordPress version is lower than 4.7, please update your WordPress to the latest version.
When using Berry theme, you can display your Instagram feed on your website: in site footer as a fullwidth section, or in a widget area (sidebar) by adding the custom widget "Berry Instagram".
Before June 2020:
For most users, there is no need to add the Instagram Access Token to display the Instagram feed on the website. Only a few users need to add the Instagram Access Token because of a connection problem between their websites and Instagram.
Since June 2020
However, starting in June 2020, Instagram made changes AGAIN, and the old API will be deprecated at the end of June 2020. The new Instagram API is currently enabled.
Because of these changes, from June 2020, it is required to add the Instagram Access Token to connect your website with your Instagram account before you can display the Instagram feed on your website.
For users who have previously added the token manually in the old way, since you are using the old Instagram API (will be deprecated after June 29, 2020), so please follow the steps below to reconnect your Instagram account.
Please follow the steps below to connect your website with your Instagram account:
"Why do I need to install these two plugins?"
Since Instagram API made changes frequently, we use this third party plugin "Smash Balloon Social Photo Feed" to manage Instagram Token. This is a plugin specifically made for Instagram feed, which is stable and frequently updated.
Bridge plugin "LoftOcean Instagram": This is a bridge plugin. After activating this plugin, the Berry theme can work with the "Smash Balloon Social Photo Feed" plugin, so your Instagram feed can be displayed in the theme’s built-in locations (sidebar and footer), with the style set by the theme.
After connecting your website with your Instagram account, you can display your Instagram feed in the site footer, or use a widget to display the feed in the sidebar.
Instagram feed in site footer:
Please open your WordPress Customizer, then go to "Footer" > find "Instagram Feed" options. Enable the option and the Instagram feed will be displayed in the site footer. You can add a title (it's optional). If you want to link the title to your Instagram profile page, please also enter your Instagram account name into the "Instagram Username" box, and then check the box of "Link Title to Instagram Account" option.
Instagram feed in sidebar:
Please use the custom widget "Berry Instagram" to display Instagram feed in the sidebar. If you are new to WordPress, you may like to read this tutorial: How to Add and Use Widgets in WordPress.
By default, the Instagram cache will exist for up to 2 hours, which means that if your Instagram has just added some new photos, those photos will not be shown on your website until the cache expires. In some cases, you may like to manually clear the cache. Please open your WordPress Customizer, go to Instagram Settings, find the "Clear Instagram Cache" option, and click the "Clear Cache" button.
Please note: this is a new feature added since Berry v1.4.
If you use any caching plugin on your site, you may find that sometimes your Instagram photos stop updating, especially if you haven't updated your site content for a while, such as posting a new article. This is because the Instagram feature uses PHP code to render content by default. When the cache plugin works, the code of the Instagram feature may not run.
To avoid this problem, please open your WordPress Customizer, go to Instagram Settings, find the "Load Instagram pictures dynamically with AJAX" option, tick the box to enable this option.
Please note: this is a new feature added since Berry v1.4.
Instagram feed cannot be displayed on your website?
Please check by following the steps below:
This problem is caused by the Instagram API change that happened on October 24, 2020. Unfortunately, this specific change was not mentioned in the Instagram announcement so we did not prepare for it in advance. We have updated the required plugin "Berry Extension" and the bridge plugin "LoftOcean Instagram" to fix this issue.
If this issue happens on your website, you need to remove the old "Berry Extension" and "LoftOcean Instagram" from your website, then download and install the updated ones. Please follow the steps below:
Berry theme uses the most popular icon font toolkit Font Awesome to display icons. When the first version of Berry was released, we used Font Awesome v4.7. Later, Font Awesome version 5 was released, and included many new icons. Therefore, we provide a new feature to allow users to choose to upgrade to Font Awesome v5.x to show new social icons, for example, Google Play, Patreon, etc.
In the customizer, please go to Font Awesome, then tick the box of the Upgrade to Font Awesome 5 for more icons option.
Please note: some icons may look different after upgrading from v4.7 to v5.x because the icons are redesigned by the toolkit author.
To display your latest blog posts on the homepage, you can:
Then go to Appearance > Customize > Blog Page, there you can customize the page layout and latest posts layout.
You can also choose a static page as the homepage, then create a new page, name it “News”, “Journal” or any other title, and set it as the posts page. Then you can style your posts page via Appearance > Customize > Blog Page.
Berry provides 3 page templates for different page layout:
To choose a template for a page, on the site dashboard, go to Pages > All Pages, choose a page to edit it, then on the right hand side, you will find Page Attributes option panel, click to open the Template drop down list, choose a template for this page.
Since version 1.3, users can choose to hide the page header specifically for each single page.
Go to Posts > Categories, when adding a new category or edit an existing one, you can upload an image for this category, then on the category archive page, this image will be used as the page header background image.
And this image will also be used for the custom widget: Berry Category widget.
To change the page layout and archive styles, please go to Customizer > Archive Pages > Category.
The author information will show:
Author information includes the author profile picture and biographical info.
To edit author biographical info, go to your site dashboard > Users > All Users, find the user you are going to edit, click to open the Edit User page, there you can edit the biographical info.
To add or edit the author profile picture, please visit https://en.gravatar.com/ for more information.
To change the page layout and archive styles, please go to Customizer > Archive Pages > Author.
To hide the author info box after single post content, please go to Customizer > Post > Author Info Box, then uncheck the box.
You can choose a default template for posts, and you are also able to choose different templates for different posts.
Please note: this feature requires WordPress 4.7. Please check your WordPress version and get the version 4.7 to use this feature.
To choose a template for a post, on the site dashboard, go to Posts > All Posts, choose a post to edit it, then on the right hand side, you will find Post Attributes option panel, click to open the Template drop down list, choose a template for this post.
There are 4 options:
If you choose "Fullwidth" or "Left Sidebar" or "Right Sidebar" for one post, then when you change the default post template in Customizer, the change will not affect this post.
Since version 1.1.5, Berry theme has 2 single post header styles for users to choose.
On your site dashboard, go to Appearance > Customize > Post, then you will see an option Single Post Header Style:
Berry supports 4 post formats: Standard, Gallery, Video and Audio.
You can choose some posts and set them as "Featured Post" manually. Then you can insert them into the Featured Slider on blog page. This is a new feature since v1.1.3.
On your dashboard, go to Posts > All Posts, then you will see the column Featured Post, tick the box of some posts to mark them as the featured posts.
You can also mark a post as featured post on its edit page.
If you have enabled "Post Like" feature, you will see a small heart icon below each post. Visitors/readers can click on the heart icon, the number will count up at every click. If your site already has many posts before using Berry theme, because your previous themes don’t have this feature, so the number is zero for every post. You can add a fake start number of hearts for each post, please see this link to know how to do it: How to add a start number for post like count.
Since version 1.1.5, we have added a checkbox on each single post edit page, so users can choose to hide or show a post's featured image on its single post page.
If checked, then the post's featured image (if uploaded) will show in the featured slider on homepage, and in the post archive list (like on homepage, category archive page, etc), but will not show on its single post page.
And please note: if a post is a gallery post (post format "Gallery"), and the post has both a featured image and a gallery, the featured image will not show on its single post page, no matter if enable the option or not.
The WordPress Excerpt is an optional summary or description of a post; in short, a post summary. And there are three different ways to show the summary to your post content.
By default, excerpt length in Berry theme is set to 25 words. So on the posts archives pages, each post displays 25 words of its content by default, and with an ellipsis … and a "Read More" button at the end. And HTML formatting and tags will be stripped from the content.
When adding <!–more–> quicktag into post content, it will display the content before the more tag when displaying your posts list, also with a "Read More" button at the end.
However, in Berry theme, if the content before the more tag is longer than 25 words (the default excerpt length set in Berry theme), then it will display content up to 25 words, and will add an ellipsis … at the end. (If the content before the more tag is shorter than 25 words, then it will not add an ellipsis.)
How to insert the more tag
When writing in the visual post editor, please click the "Insert Read More tag" button to insert a more tag.
When using the text editor, you can insert the more tag by clicking the "more" button or typing it manually: <!--more-->.
A manual excerpt is the hand-crafted summaries of your content.
To add manual excerpt, please write excerpt in the Excerpt field under the post editor.
The result on website:
If you can't find the Excerpt field, it is most likely hidden by default. Please scroll up to the top of the post edit screen, and click the Screen Options, then make sure the Excerpt box is checked.
Berry provides 1 widgets area: the left/right sidebar when the page template is not “Fullwidth”. To manage widgets, you can:
You can add widgets into the sidebar, and drag to reorder the items.
There are 8 custom widgets included in Berry.
Add brief information about you and your site.
Display selected (up to 5) categories with background image in the sidebar.
Each category's background image can be added/edited via Dashboard > Posts > Categories.
Please hold the CTRL key (PC) or COMMAND key (Mac) to select multiple items.
Upload an image and enter a link to the page you are advertising/promoting about. And you can also choose to open it in the current tab or a new tab.
The custom latest posts widget will show your latest posts with the featured image, post title and meta info.
The custom latest comments widget will show the latest comments with comment author photo, post title and comment publish date.
Add this custom widget into your sidebar to show your social menu.
Enter the username of an Instagram account to display the latest photos from this account. And you can decide how many pictures to show in the feed.
Enter your Facebook page URL to display the Facebook like box.
To make sure images on your site always look sharp and clear on all devices, the recommended width of images is at least 1600 px when it is supposed to be a full-width image.
Images will be scaled and saved into different sizes after you upload them. You can set image sizes via dashboard > Settings > Media.
Recommended media sizes for Berry theme:
After you change the media size settings, when you upload new images they will be scaled and saved into the new sizes. But for the existing images, you can use this plugin to regenerate the new sizes: Force Regenerate Thumbnails.
We suggest use images in 3:2 aspect ratio for the features images and photos in a gallery (especially a slider gallery).
We have included tips and resources related to this topic in this how-to article:
Berry theme is officially compatible with WPML. Which means you can turn Berry multilingual with WPML. Please read guide below to know how to build a multilingual site with Berry and WPML.
Before you can start translating, you need to create pages and posts in the site’s default language.
For example, navigate to "Pages" and add a new page (as you would without WPML). You will see there is a Language panel on the page.
After publish a new page or a post, you will see Translate This Document in the Language panel and a list of languages.
Click on the "+" button of the language you are about to translate the content to. For example, "Serbian". This creates a new Serbian translation for it. Then enter the content written in Serbian. And publish the page.
Once you have translated the page, it will display the title and content in the language of your choice.
On your WordPress site dashboard, go to Pages or Posts, in the list you will see a column for each active language, with a pencil icon (for 'edit translation') or a '+' icon (for 'add translation') next to each page/post.
For example, the page "Our Team" hasn't been trasnlated yet, so the icon is "+". Click on it to create a new Serbian translation for this page.
When you’ve already translated, the "+" icon will change to a pencil icon. Click on the pencil icon if you need to modify your translation.
Sometimes, you need to use the same, untranslated contents in other languages. In this case, WPML provides a content duplication feature. To read more about this topic, please visit the page about displaying untranslated content using content duplication.
Translating post tags is just as same as translating categories. The only difference is you only need to enter tag Name and Slug.
You can also translate post categories and tags via WPML Taxonomy Translation.
To translate the theme strings, you will need to scan it for strings. This will register the strings for translation on the String Translation screen. (Read more about Theme and Plugin Localization.)
This can be done by following the steps below:
What you need to translate via String Translation screen:
For example: Translating Berry's custom widget - Berry Profile:
WPML lets you translate WordPress menus and create different menus per language. You can translate menus manually, or have WPML synchronize menu content. Please check Translating Menus for more details.
WPML lets you easily translate your Widgets via the String Translation screen. This requires that the WPML String Translation module is installed. The module is available in the Multilingual CMS version.
And we have talked about how to translate Berry's custom widget "Berry Profile" via the String Translation screen in sub section - 8.4.4 Translating Berry's theme text and other strings.
Go to Appearance > Menus, click on Customize the language switcher button.
The Edit Menu Language Switcher screen will pop up. There you can customize the language switcher.
If you need help with using WPML with Berry theme, please head over to WPML technical forum. Before posting about issues, we recommend that you review this quick checklist:
Please always remember to search and read WPML official documentation for more details about how to use WPML.
When you purchasing products from Envato Market, a supported item includes item support for 6 months from the purchase date. During those 6 months, we (as the author of the theme) are available to provide the item support services.
You may like to read more details about What is Item Support?.
We can help with:
We cannot help with:
Please check ThemeForest Item Support Policy for more details.
Please kindly note: The terms and conditions are set out by Envato exclusively, and every author must follow the rules. These rules are the same for every author and every buyer and we cannot change them selectively. Thank you for understanding.
To speed along the support request, please check by following the guide below:
When submitting your support request, please include the following information in as much detail as possible so that we can get more clues about your questions/problems:
And please write in English. Thanks!
If you have less than 6 months remaining on a support item you’re eligible to renew your support. For more information about Item Support renewals, please see Extending and Renewing Item Support.