Home Page Featured Categories (Portobello)
Learn how to configure and use the featured categories home page module. In your control panel, go to Storefront > My Themes, click the blue "Customize" button to launch Theme Editor, then select the "Theme Styles" icon. In the left hand column of the Theme Editor, click the panel labelled 'Home Page Featured Categories'.
We have included a custom panel that will pull in specific categories that you want to feature. This is flexible enough for the store owner to determine which categories they want to feature without having to base it off an existing category structure.
Check Enable featured categories on the home page to enable this feature.
Once activated, the panel will search for a category you have designated as the top level featured category. You can do this in your control panel by creating a new category, or choosing an existing one. Under the chosen category, add new sub categories - these will appear as featured categories on the home page.
You can assign existing products to appear under these featured categories in addition to their current category assignments.
Set the name of this category in the 'Featured Category Name' field. Note that this field has a 64 character limit and is case sensitive.
The panel will locate the specified top level category, and providing it contains subcategories, will list those as the "Featured Categories" on the homepage. We recommend setting up a category image in the control panel for each featured category that is pulled through into the grid.
Create a new category ( Products > Product Categories). We suggest you call it "Featured Categories".
Within the new category add any sub-categories that you want to be displayed on the homepage.
Please note that for these sub-categories to be visible on your storefront, Menu Display Depth ( Store Setup > Store Settings > Display > Category Settings > Menu Display Depth) must be a minimum of 2 levels deep.
Add a category image to each of the sub-categories in the 'Featured Categories' category.
You must add the images using the category image field, shown above, images in the category description aren't used for this feature.
Open the theme editor, 'Home Page Featured Categories' section ( Storefront > My themes > (Current Theme) Customize > Home Page Featured Categories), and put a check mark in 'Enable featured categories on the home page' (see below).
In this same section the 'Featured category name' must exactly match the name of the top level category you set up in step 1. This is case sensitive. So if, as suggested, you called the new category "Featured Categories", you must enter "Featured Categories" in this field.
As noted above the 'Featured category name' entered in the theme editor, must be exactly the same as that entered in step 1. The field has a 64 character limit and is case sensitive. So entering "Featured Categories" as the field name and "Featured categories" in the theme editor would NOT work.
That's it! Open your home page, and your featured categories will show.
Home Page Featured Category Columns
Set how many columns of categories are displayed on the home page.
Hide Category Names in the Grid
If you have uploaded images to your featured categories that already include text, check this option to prevent the text label for each category appearing.
Hide "Featured Categories" Title
This will prevent the "Featured Categories" title from appearing above the grid, if you want the theme to show a grid of images directly below the main hero image.
Hide Featured Categories in the Main Navigation
Activating this option will hide the specified top level "featured" category from the main navigation bar.
Please note 'Featured Categories' must be ticked as "Visible In Menu" in the Products > Product Categories list, even if you don't want it to appear in the Main Navigation. Use this Theme Editor setting to hide it from the Main Navigation.