The help guide for Koi WordPress theme by ThemeBeans.

Included Files

After downloading the theme package open the folder named “Koi Package (Version)” and un-zip the folder, if it is not already so. Inside the package you will find the following files:

  • Demo XML
  • Help
  • Licensing
  • Sources
  • Theme
    • Koi
    • Koi.zip
    • Koi-child.zip

WordPress Upload

To upload through your Dashboard, select “Appearance” and then “Themes”. Next, select the “Install Themes” tab at the top of the page and then select the “Upload” link, right above the search field. Choose your file and select “Install Now”. Once the theme is fully uploaded and installed, click “Activate” to activate the WordPress theme.

The theme files will be stored on your server in the following location: /wp-content/themes/

When uploading your theme with the installer, please ensure you are uploading the theme .zip file, not the entire package you downloaded. In this case, you will be uploading koi.zip.

Bean Help Center

If you’re a problem with the theme or found a bug please let us know on the Bean Help Center. We take pride in our customer support and we will do what we can to assist you.

If you are experiencing a theme issue, please first turn off all third party plugins to see if the problem persists. If so, we will be glad to help.

We are happy to help with setup & bugs you may stumble upon though we cannot support CSS customizations.

FTP Upload

To manually upload your new WordPress theme, login with your credentials to your website and locate the wp-content folder in your WordPress install files. Upload the un-zipped Koi folder into the: wp-content/themes folder.

Once uploaded, activate the theme by heading to the “Themes” menu in the WordPress Dashboard. Locate the Koi theme and hit “Activate”.

Bean Plugins

This theme is compatible with many of our custom developed WordPress Plugins. Head over and Download our Bean Plugins.

It is rather important to set your theme menu in the WordPress Dashboard. To do this, locate the Menu options by selecting the “Appearance” tab from the dashboard sidebar and then “Menus”.

Once you’re viewing the Menus, create a new menu and save it. After you’ve saved the menu, you can add it to a menu via the Menu Settings, below the Menu Structure area. Add your pages and links to the menu you just created in the Menu Structure area.

If you’re theme menu does not accurately display in mobile view, the error most likely is caused by the unselected menu here.

Dedicated Mobile Menu

Koi has a special dedicated mobile menu, labeled "Mobile Menu". If you add create and add menu items to this menu, then it will display in lieu of your default menu.

Latest Posts as Home

The first step is to set your home page as your latest posts in WordPress. To do this, head back into your WordPress Dashboard and from the sidebar links, hover on “General Settings” and click on “Reading”. Choose to have your front page displayed as “Latest Posts” and save.

Page Template as Home

The demo is currently running the Portfolio Filtered Template as the site home. To set up the portfolio home page, simply create a page using the “Portfolio Template” and publish it. Then in the WordPress Dashboard > General > Reading Settings - you must set your Posts page, which will be the default index page, and your home page (the page you just created).

Alternatively, you may select the page in the Theme Customizer

Add a Blog Post

From within your WordPress Dashboard, navigate to the “Posts” tab (located in the Dashboard sidebar) and click on “Add New”. Select the post format on the right sidebar and the format specific meta fields will appear below the editor. Don't forget to upload your featured image!

Other Post Formats

This theme has built in functionality for many other alternative post formats: audio, video, aside, link and quote formats. To use them, again you would select them from the Format meta box beneath the Publish box.

Gallery Post Format

To publish a gallery post format select "Gallery" from the Post Format metabox. You will notice a "Gallery Post Format Settings" metabox appear below the post editor. Upload your images in this metabox here, NOT the Add Media button above the post editor. You can add images from your media library, upload new media and rearrange the images as you wish. You also have the option to make the post image appear in a randomized fashion via a check box below the uploader.

Post Custom Background

From the post editor you will also notice a "Background Settings" metabox. Here you may select a custom background color and choose to make the Featured Image opaque. This can lead to neat effects on your blog.

Changing the Post Author

To change the post author - which is a default WordPress functionality - select the “Author” checkbox from the “Screen Options” tab, located at the top right of the WordPress editor.

Plugin Installation

To install the plugin, head over to our website and simply download the free Bean Portfolios Plugin. Once you’ve successfully downloaded the zip file, head to your WordPress Dashboard and select “Plugins > Add New > Upload.” Add the zipped file in the field there and click “Upload.”

Upon a successful upload, you’ll be prompted to activate the plugin. You’ll then see a new “Portfolio” tab in your WordPress Dashboard Sidebar. Creating portfolio posts is done exactly the same as standard posts.

Creating your Portfolio Page

You need to first create a page using the “Portfolio” template. This template notices that you have the Bean Portfolio Plugin activated and will pull your published portfolio posts.

Portfolio Post Formats

Koi is capable of displaying audio, video, slideshow and stacked image portfolio posts. To change the type of portfolio to display, click on the select field for "Portfolio Type" in the Portfolio Meta Settings, located beneath the post editor.

Portfolio Gallery Images

If you have selected Gallery Portfolio, the Gallery Post Format Settings will appear below. Here you will add in your images to the post's gallery by clicking the "Browse & Upload" button. You have the capability to rearrange, caption, add more and remove images from the popup modal that appears. Just remember to hit "Save Gallery" and you're all set.

Recommended size for portfolio gallery images is as large as you want to upload. There are no limitations.

Portfolio Featured Images

We utilized 800px by 600px for an optimal display of the portfolio grid.

Included Widgets

  • Dribbble Shots Widget
  • Flickr Photostream Widget
  • Portfolio Widget
  • Portfolio Taxonomy Widget
  • Embedded Video Widget

Using the Widgets

To employ a widget, simply go to your Widgets editor (located in your WordPress Dashboard in the “Appearance” menu) and drag your widgets into the specified widget areas.

Bean Plugin Widgets

The following widgets are provided with our compatible array of plugins. Download them all.

  • Bean Tweets Widget
  • Bean Instagram Widget
  • Bean Social Widget

Accessing the Customizer

There are a couple ways to get to the Theme Customizer. You can select the “Customize” button in the admin bar or select “Customize” from the Dashboard menu.

Theme Settings

Theme Settings: Enable Retina.js, Bean Framework SEO metaboxes and select to enable a logo letter option.

General Settings: Upload your logo/login logo/favicon/apple touch icon, footer copyright text and even add your analytics script.

Blog Settings: Here you may choose to utilize the post thumb hovers, show post tags, add your custom post excerpt word count. You also have the option to turn on blog pagination and social sharing.

Contact Template:Choose to display the required asterisks, set your contact form email address and customize the "Send" button text.

404 & Coming Soon Settings: Customize the 404 header, 404 text, and set the year, month & day for the Coming Soon template.


Custom Styles: Easily manipulate various CSS elements throughout the theme with the color pickers in this tab.

Custom CSS: Insert your own CSS into this block and it will be applied to your website. This overrides all default styles located throughout the theme.

These colors will override all other theme stylesheets. Deleting the color inputted will allow the stylesheets display.

Portfolio Settings

Portfolio Options Enable the sliding overlay, the grid meta (categories or views), lightbox feature, likes feature, single pagination, sharing, and turn off/on the More Projects loop below the single portfolio post.

Portfolio Loop: A neat feature of Koi is the ability to set the page loop for your portfolio posts. You can select to display your posts by most recent, most views or by random. You can select how many posts to appear on your page as well.

Portfolio CSS Filters: Easily manipulate the look of your portfolio by changing the CSS filter. The available options are Black & White, Sepia Tone and High Saturation.

Image Asset Customization

Each graphical asset has an associated retina image that should be modified when customizing assets in this theme. You will find these retina assets in their respective image locations, in the “retina” folders. Additionally, if the image size has changed, the background-size property of the associated class in /assets/css/mobile.css must be modified to reflect those changes.


This theme is retina.js ready - which means that any image will be replaced by a retina image if you’ve uploaded one into the same directory & have appended the “@2x” to the end. Example: logo@2x.png will replace logo.png

WordPress will modify the asset name of any identically named uploads. Make sure your retina assets are the named identically - with "@2x" appended.

Included Templates

Koi has the following templates built into the theme and can be applied by creating and saving a page in WordPress.

  • Post Archives Template
  • Contact Template
  • Coming Soon Template
  • Default Template
  • Portfolio Template
  • Portfolio Filtered Template
  • Under Construction

Optional Page Title

You may select to add the page title to your page on each page. This only applies for the pages that display page titles and is located in the "Page Meta Settings" below the page editor.

Included Stylesheets

These are the primary CSS files used for general front-end styling. Use these to customize your theme even further.

  • 1. style.css - Primary stylesheet
  • 2. assets/css/mobile.css - Responsive stylesheet
  • 3. assets/css/framework.css - Framework stylesheet

Included Javascript

These are the various attribution inks to the Javascript files included or modified to work with in this theme.

  • 1. jPlayer - www.jplayer.org
  • 2. Isotope - www.isotope.metafizzy.co
  • 3. Flexslider - www.woothemes.com/flexslider