Getting StartedBack to Top

This document covers the installation, set up, and use of this theme, and provides answers and solutions to common problems. We encourage you to first read this document thoroughly if you are experiencing any difficulties before contacting our support team.

York Pro

This help guide also covers features that are only available in the Pro Version of York. If you're interested in upgrading to pro, click here to learn more about the new features or go ahead and purchase York Pro for only $59.

York Pro has many more customization options including typographic selectors, stylistic color pickers and other add-ons. And in addition to these fantastic features, you'll also receive dashboard one-click updates and access to world-class theme support by our team of in-house professional WordPress developers.

Please note that support is only offered for York Pro. If you already have a Pro license and have any questions that are beyond the scope of this document, feel free to ask us via our dedicated help center.

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 wp-content/themes location.

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

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 York folder into the: wp-content/themes folder.

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

Customizer Options Import

Located inside the /customizer folder within the package contents, you'll find a york-export.dat file. This file contains the live demo's Theme Customizer options.

To import, first install and activate the Customizer Export/Import WordPress plugin, which is available as a free download. After you're successfully running the plugin, head to your Theme Customizer and look for the Export/Import section.

Import the york-export.dat file with the uploader within that section and hit "Import".

Find out more on installing and activating plugins.

Premium Theme Setup

If you're looking for WordPress theme installation and setup to look exactly like the live theme demo - then we're here to help. Fast & simple for only $89.

Get the advanced Theme Setup service →

Our in-house team of professional developers will install the theme, upload the demo XML file, and setup your website exactly like the live demo. Frustration free. Complete your purchase of the Theme Setup service by clicking the link above and send us your deliverables.


Theme Support

If you have a problem with the theme or found a bug, please let us know via our official 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.

Please note that support is only offered for York Pro. If you already have a Pro license and have any questions that are beyond the scope of this document, feel free to ask us via our dedicated help center.

Set up your Home PageBack to Top

1. Create a New Page

First, create a new page on your website, with the WP Dashboard > Pages > Add New link.

2. Navigate to the Customizer

Next, you will need to set the page as your site's front page, via the WP Dashboard > Appearance > Customize page, within the Static Front Page panel.

3. Set a Static Page

Next, to establish a static page, open the Static Front Page panel, within the Customizer.

4. Assign a Front Page

From the “Static Front Page” panel, select the static page option. This will set your website to display a page, instead of a blogroll, on the home page.Next select the templated page you first created as the Front Page option. Then hit the Save & Publish button up at the top of the Customizer window, and you should be all set.

PagesBack to Top

Entry Header Animation

Below is an example of the animation code deployed on the York Pro demo. Simply add this to the Entry Header textarea within the "Page Settings" metabox (located beneath the page editor). Modify the text and add <b> elements as needed.

PortfolioBack to Top

Portfolio Plugin Installation

To install the Bean Portoflio plugin, head over to our website and simply download the free Bean Portfolio WordPress 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.

Featured Images

Upload a featured image - any size will work. The images will be automatically applied throughout all the neccessary templates and loops.

Grid Thumbnail Size

Within the Portfolio Settings metabox, you may set the grid size for your portfolio project's featured image - that's used on the portfolio templates. There are four options: small, medium, large and xtra-large.

Gallery Images

This is where you will add your images to the post 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.

Portfolio Captions

You may add captions to your portfolio gallery image uploads within the Edit Gallery modal (the same modal where you orignially uploaded images to your portfolio post). Just add your caption to the "Caption this image" text box directly below each image, and your caption will appear on the portfolio post.

Portfolio Post Formats

York is capable of outputting gallery and video portfolio posts (embedded - e.g. Vimeo & YouTube). To change the type of portfolio to display, click on the checkboxes under the "Portfolio Format" metabox, located beneath the Portfolio Categories, on the right hand side of your window.

Mix or match video and gallery posts on the same post.

Portfolio Meta

Each portfolio post has selectable meta options that you may choose to use on each individual post. You can set the date, client, role, url, elect to display the categories, tags, views and the portfolio post title.

You can also add an external URL to which your post loop will link to a different URL than it's single post page. For example, you can create a post with a featured image and an external link to your Behance project page - then promote that project within the portfolio templates.

Portfolio Options

Located within the Theme Customizer you will find a Portfolio section. Here you may elect to enable the singular portfolio loop, portfolio sorting, lazy-loading, photoswipe and enter your portfolio count.

WidgetsBack to Top

Bean Plugin Widgets

The following widgets are provided with our compatible array of free plugins.

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.

CustomizerBack to Top

To access the live Customizer, you may select the Customize button in the admin bar dropdown or select "Customize" from the Dashboard menu. Note that you must be logged in as a site administrator in order to access the controls.

Theme Options

1. Title

Set your site title, tagline, logo and the site icon. You can also elect to retina-fy your logo.

2. Header

Turn off/on the sidebar flyout as well as the social navigational icons in the flyout. Also modify these colors: site title, site title hover, navigation icon, navigation icon hover and social icons.

3. Portfolio

Decide if you'd like the gallery lazy loading active and the Photoswipe lightbox on. Enable the "Next" portfolio navigation feature. Lastly, enter the number of posts you'd like displayed originally on your portfolio template. Regarding colors, you may modify the overlay and overlay text colors.

4. Contact

Set your contact form email address and customize the form submit button.

5. Footer

Turn on/off the "Powered by York Pro". Enable the Footer Call to Action and all relevant options. There's also all footer styling options to select the text color, link hover color, and social icons color.

Customizer Styles & Fonts

1. Colors

Easily manipulate the theme accent color and other elements throughout the theme with the color picker in this tab.

2. CSS3 Filter

Within the Portfolio section of the Customizer, you'll find a select field to set an optional CSS3 Filter value (Black & White and Sepia). If activated, your portfolio items will default with the selected filter active.

3. Typography

Easily modify the fonts throughout the theme - choosing from the entire Google fonts library.

PluginsBack to Top

To install any of our free plugins, head over to our website and simply download the plugin files. Once you’ve successfully downloaded a 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.

ThemeBeans Plugins

York is compatible with many of our custom developed WordPress Plugins. Head over to our website and download our free plugins now →

RetinaBack to Top

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.

Additionally, if the image size has changed, the background-size property of the associated class in /style.css must be modified to reflect those changes. You can find this in the Retina CSS section at the very bottom of the main stylesheet.

UpdatesBack to Top

If you've requested and entered your theme license key, then you'll automatically be notified of any theme updates as we push them. This is the most effective method for getting updates pushed to you quickly and effienctly. Read more about theme licenses.

Check for Updates

To check your theme version, click the live changelog link below and check the version number at the top of the changelog.txt file:

View the York theme changelog →

Relay the changelog version at the top of that changelog.txt file with the version in your WordPress Dashboard > Appearance > Themes section to see if your theme files are up to date.

If you are in need of the update, download the current build from the location you purchased the theme from (either ThemeForest, Creative Market or via your account dashboard) to install the updated theme.

If you have an active license key applied to your theme, you will receive live update notifications to which allows one-click updates directly from your WordPress dashboard.

FTP Updating

If you have not customized the original theme files then you may simply drop the updated theme folder contents into the theme folder on your server – which is located in wp-content/themes/york.

If you wish to upload the entire updated theme as a separate theme, ensure you:

If you choose to upload the whole theme and switch to it, you may lose your Theme Customizer data and will have to add those back in.

FTP Selective Updating

On the other hand, if you have customized some files in the core theme contents, you should consider selective updating, which simply means updating only the files that are pointed out in the theme’s changelog.

There are a couple programs out there that will allow you to compare versions of files, in order to catch customizations you may not remember. Some recommended programs are WinMerge (Windows), Kaleidoscope (OSX), and handy GitHub (OSX) & (Windows).


Overall, the safest and cleanest way to update your theme is to leave your currently modified theme on your server/site as is, rename the folder of the newly updated theme, upload the new theme, and modify that to match your original custom work. In this way, if something has gone wrong with the new version, you’re just a few clicks away from getting things back to how they originally were.

Please note that ThemeBeans is not responsible for content loss, database errors and such, which may happen to your WordPress install upon an incorrectly applied theme update.

Theme LicenseBack to Top

It’s strongly recommended that you add your theme’s license key from within the License section of the WordPress Customizer. By adding your key, you will activate the remote theme updates and have access to our support team.

You can find your theme’s license key by checking your purchase receipt or signing in to your ThemeBeans account. If you purchased the theme from ThemeForest, you may request your license key here. You’ll need your ThemeForest purchase code handy.

Copy this key and navigate to the Customizer License Control located within the WordPress Dashboard > Customizer > Theme License section. Enter your license key and hit activate.

You'll see a "Verified" report upon a successful activation. If the license does not activate, please refresh and try again.

Please note that licenses are only given for York Pro - not the free version.

What is the license key for?

It is important to keep your license up to date in order to continue getting updates for your ThemeBeans WordPress theme and support for any issues you may encounter. Renewing your license grants you access to support and updates for another year, including all updates for bug fixes and feature introductions.

Without a valid theme license, you will be unable to get support and auto-update notifications will not function.

If your key is not activated after hitting the Activate button, simply refresh the Customizer and try again. Sometimes it takes a second try to properly establish a connection with the activation server.

What if my license key has expired?

After a year, license keys may be renewed. You will get a renewal notification on your WordPress dashboard if your license is about to expire, or has in fact expired.

Join our Theme ClubBack to Top

Download our entire WordPress theme catalog, plus every theme we make in the next year, for less than the price of two!

Wether you’re a suave freelancer knocking out WordPress websites for clients or just like to freshen up your portfolio every so often (or both!), the ThemeBeans Theme Club has the most beautiful WordPress themes around – so join today!

Just purchased one of our themes?

If you've just purchased a theme but would like to join to the ThemeBeans Club, you can easily upgrade at a pro-rated rate. 🙌

Simply log into your ThemeBeans account and click the Upgrade to Club link at the top right, under your profile avatar. Complete the checkout process and you'll have instant access to the entire ThemeBeans WordPress theme catalog.