Perfect WooCommerce Brands is a perfect tool to organize your site, highlight the brands you have, and also helps as a filter for your customers at UX exploration. PWB extendes the product’s description and presentation at your e-commerce site. Whether we like to admit it or not, we are all influenced by brands.

Plugin Version: 3.5.7
 
WordPress plugin CodeCanyon Perfect WooCommerce Brands

Plugin Features

Brands are a guarantee for quality, they assure product recognition in customers. Is essential to work with product brands for increase sales and generate reliability on your e-commerce site. With this extension you can add product brands to your WooCommerce site.

Specifications:

Release date: 10-08-2020
Last updated: 21-07-2026
Type: Paid
License: GPL 
Subject: e-Commerce for WooCommerce
Compatibility: W5.x W6.x
Includes: Plugin
Language packs: English
Developer: CodeCanyon

Rating:
4.5652173913043 1 1 1 1 1 (207 Votes)

Download by subscription!

You need to log in on the site and purchase a club subscription!

Share with your friends!

 

Guide to CodeCanyon Perfect WooCommerce Brands: how to set up brands, filters, and manufacturer pages in WooCommerce

CodeCanyon Perfect WooCommerce Brands is not meant to add a few logos to your site for decoration. Its practical value is turning brands into a dedicated navigation layer in your WooCommerce store: each brand gets its own profile, logo, banner, link, product archive, placement on the product page, widgets, shortcodes, and a catalog filter. In this guide, we will walk through how to prepare your store, install the plugin, configure the core settings, display brands across your pages, and verify that shoppers can actually find the products they need.

CodeCanyon Perfect WooCommerce Brands as a WooCommerce brand structure diagram
The overall logic of the guide: a brand connects the product, archive, catalog filter, and logo blocks.

This article is written as a hands-on guide that continues where the short product description leaves off. It does not repeat the product listing. Instead, it explains where brands genuinely improve a store, which settings to touch first, why 404 pages sometimes appear after updates, how to use shortcodes, and when WooCommerce's built-in Product Brands or another plugin may be the better choice.

Special attention is given to a common gray area: WooCommerce now has its own brand feature, while Perfect Brands for WooCommerce uses its own taxonomy. If your site already has brands, manufacturer attributes, data imported from another plugin, or SEO pages with established permalinks, the right place to start is by reviewing the existing structure, not by installing the plugin on a live store.

Where brands genuinely help a store

In WooCommerce, a brand is often confused with a category, tag, or standard attribute. A category answers the question "what kind of product is this": sneakers, smartphones, auto parts, cosmetics. An attribute describes a technical characteristic: size, color, material, compatibility. A brand answers "who makes it" or "what trademark is behind it." If shoppers come to your store looking for specific labels, the brand becomes just as important a filter as price or category.

Perfect WooCommerce Brands is especially useful where logos, trust in the manufacturer, and fast access to products from the same label influence the buying decision. That includes apparel stores, electronics shops, accessories, cosmetics, auto parts, tools, sporting goods, B2B catalogs, and marketplace-style storefronts. In projects like these, brand-based navigation reduces clutter: the customer can open a manufacturer page, view all products from that brand, narrow the catalog with a filter, and jump to related items.

If your store sells only your own products under a single label, a separate brand layer may be unnecessary. In that case, categories, collections, tags, or landing pages are often enough. The plugin may also be a poor fit if your store is already built around WooCommerce's native Product Brands and you do not want to maintain two brand systems at the same time.

When a dedicated brand plugin provides real value
Store scenarioHow to use brandsWhat to check in advance
Many manufacturers in the same category Add a brand filter and a page that lists all brands. Make sure brands are not duplicated as categories and attributes.
You have popular labels people search for by name Add a logo carousel to the homepage or catalog page. Make sure you have enough high-quality logos in a consistent size.
You need SEO-focused manufacturer pages Fill in the brand description, banner, and product archive. Check that the brand slug does not conflict with existing URLs.
Migrating from another brand plugin Use import/export and test everything on a site copy first. Identify the source taxonomy: pwb-brand, product_brand, or pa_brand.

What to check before installation

Preparation matters more than installation itself. Perfect Brands for WooCommerce stores brands as a separate taxonomy and adds its own screens to the admin panel. If your site already uses WooCommerce's built-in brand feature, another brand plugin, an attribute-based filter, or an SEO plugin that controls taxonomy archives, installing it without checking first can lead to duplicate menu items, empty archives, or permalink conflicts.

WordPress, WooCommerce, and PHP compatibility

Before testing, open the plugin page on WordPress.org and review the changelog. That is where you will find the current version, minimum requirements, tested WordPress version, and compatibility notes. Those details cannot be treated as permanent because they change over time. The practical approach is simple: check the WordPress.org metadata, review the changelog for recent releases, and only then install the plugin on a staging copy of the site.

Do not update or install the plugin directly on a live store if you already have active brand pages and search traffic. Back up the database first, save a list of your current brand URLs, review the active filtering plugins, and make sure you can disable the new component quickly if needed.

Whether WooCommerce brands already exist

WooCommerce is actively developing its own Product Brands feature. For a new store, that may be enough. For a store already using Perfect Brands, compatibility becomes the real question. Different systems use different taxonomies: Perfect Brands typically uses pwb-brand, WooCommerce uses product_brand, and if brands were previously created as an attribute, you may be dealing with pa_brand. These names matter for imports, filters, the REST API, shortcodes, and permalinks.

The main pre-installation check is this: open your plugin list and the Products section, find every place where Brands, Brand, Manufacturer, or Make is already being used, and note which system is responsible for each one.

Permalinks, cache, and theme

Brand page issues often look the same: the logo exists, the brand is assigned to a product, but the public link returns a 404 or opens an empty archive. The cause may be outdated URL rules, the same brands base being used by two systems, caching, a theme template, or a third-party filter. That is why it makes sense to clear cache only on a staging copy before installation, resave permalinks after changing the slug, and test the store with a default theme or at least without aggressive HTML optimizers.

Installation and the first safe check

The official documentation describes several installation methods: from the WordPress admin panel, by uploading a ZIP archive, through the hosting file manager, or via FTP. For a typical site, the safest place to start is the admin panel on a staging copy. WordPress will place the files in the correct folder automatically and show whether the plugin activates without a fatal error.

Installing from the admin panel

  1. Open Plugins and click Add New.
  2. Search for Perfect Brands for WooCommerce or upload the ZIP file if you have a separate archive.
  3. Click Install, then Activate.
  4. After activation, check whether Products > Brands appears.
  5. Open WooCommerce > Settings > Brands and confirm that the settings tab is available.

If the Plugins screen freezes, you get a white screen, or the admin area becomes unavailable, do not start editing WordPress core files. Roll back to your backup or disable the plugin using the standard method in your hosting panel, then check the PHP error log. On a production store, this kind of test is best done on a staging copy.

What to verify right after activation

Do not start by creating dozens of brands. Create one test brand, assign it to one test product, and check the full path: product page, brand archive, shortcode, filter, logo size. If that small scenario works, you can move on to bulk data entry. If it does not, troubleshooting one brand is much easier than troubleshooting hundreds of terms.

The brand as a standalone profile: logo, banner, link, and description

The plugin's core entity is the brand profile under Products > Brands. It resembles a standard WordPress taxonomy term, but it is extended with store-specific fields such as a logo, banner, link, description, and product relationships. That profile is then used in archives, carousels, widgets, filters, and blocks on the product page.

How to create a brand

Open Products > Brands. In the add form, enter the name, a clean slug, the description, the logo, and a banner if needed. The name should be clear to the shopper. The slug is best kept short, stable, and written in Latin characters. If the brand is already indexed, changing the slug too often will create a chain of redirects and unnecessary troubleshooting.

Use the logo as a compact visual mark for the catalog, carousel, and widgets. The banner belongs on the brand page if you want that page to feel more like a dedicated manufacturer landing page. The description should not repeat the same generic marketing paragraph for every brand. A better approach is to explain why the brand matters to the shopper, which product categories it is associated with, and how to choose the right product line.

Assigning a brand to a product

After creating the brand, open the product editing screen. A Brands metabox should appear in the sidebar area. Select the correct label, update the product, and open the public page. If the setting that displays the brand on the product page is enabled, you should see a logo or link in the selected location. If nothing appears, check the Single Product settings and do not confuse assigning a brand with displaying it on the storefront.

Brand setup in CodeCanyon Perfect WooCommerce Brands
It is best to test brand creation on a single product first: the brand profile, the product assignment, and the public-facing result.

Importing and exporting brands

The Perfect Brands documentation describes exporting and importing brand data through a brands.json file. That is convenient for moving data between sites, but it is not a substitute for a full store migration. Before importing, check whether the incoming brand slugs match existing terms, whether logo dimensions are consistent, and whether the target site already uses another brand system.

How to manage brand data without chaos

The most common organizational mistake is treating the brand as just another random field on the product screen. The result is that the same manufacturer appears under three variations: the full name, an abbreviation, and a misspelled version. To a shopper, those look like different brands. For filtering, they create empty or nearly empty groups. Before entering data at scale, create a small reference sheet: the exact brand name, slug, logo, short description, link to the brand's official site, associated product categories, and the editor responsible for it.

One brand should have one stable slug and one primary term in WooCommerce. If you need to show a localized name, use translation or the description instead of creating a second brand. If a brand has been renamed, decide what to do with the old URL first: keep it as a historical term, set up a redirect, or merge the products under the new name. That is an editorial decision, not a plugin setting.

For large catalogs, it helps to agree on logo rules. For example: transparent PNG or SVG, consistent visual height, no extra marketing slogans, and no fine print that disappears in a carousel. Perfect Brands can display an image, but it cannot turn a poor source file into a polished UI element. The earlier you normalize your media library, the fewer CSS fixes you will need after launch.

What to configure in WooCommerce > Settings > Brands

The settings section becomes the central place to work after installation. The documentation mentions tabs such as General, Brand page & Loops, and Developer. The exact set of options may differ depending on the plugin version, free or paid edition, theme, and active integrations, but the setup logic stays the same: start with URLs and basic image sizes, then configure page output, and only after that move on to import and diagnostic tools.

General: slug, logo size, and the brands page

The slug defines the base URL for brand archives. If you change it on a live site, save the old URLs first and decide whether redirects are needed. For a new store, choose a clear option that does not conflict with an existing /brands/ page, a product category, an attribute, or WooCommerce's built-in brands.

Logo size affects how the image looks in carousels, lists, and product cards. Small images will look blurry, while oversized ones will add unnecessary page weight. For a typical store, it helps to standardize all logos into one visual format: transparent background, enough padding around the mark, and a consistent height. The plugin can output the image, but it will not fix a messy media library for you.

Brand page & Loops: description, banner, and catalog display

The brand page can display a description and a banner. Do not enable everything just because the option exists. If the descriptions are short and repetitive, it is better to hide them until they have been edited properly. If banners are missing for some brands, check that the layout does not break. Displaying brands inside the product loop is useful in a catalog where shoppers compare products from different manufacturers, but on a very dense grid it can overload the product card.

Developer: import, dummy data, and system status

Developer tools should be used carefully. Dummy data is useful for quickly seeing how brands look, but test brands do not belong on a live store. Import brands helps during migration, and system status helps you collect information for support. Always run imports on a site copy first because brands are tied to products and permalinks.

If you are moving brand data from another solution, keep the stages separate. First import the brands themselves and confirm they appear in Products > Brands. Then assign products separately, verify the archives, and only after that enable public carousels and filters. That order is easier to roll back: if the slugs do not match, you fix the terms; if products are not linked, you fix the product import; if the public side breaks, you go back to the display settings.

Basic settings map after installation
SettingWhy it mattersSafe validation
Brand slug Defines the URL structure of brand archives. Check for conflicts and resave permalinks.
Brand logo size Controls the logo size on the public-facing site. Open a product page and a carousel on different screen sizes.
Brands page Links the global list of brands to a selected page. Make sure the page does not duplicate the archive slug.
Show brands in a loop Displays the brand in catalog product cards. Compare the product card before and after enabling it.
Import brands Moves brand data between sites. Test on a staging copy with a database backup.

Brand pages and archives: how to avoid an empty storefront

A brand archive is not just a static page. It is assembled from the brand term, linked products, WooCommerce templates, plugin settings, and WordPress permalink rules. That means the same symptom can have several causes: the brand is not assigned to products, the slug conflicts with something else, the URL rules are outdated, the theme overrides the template, or another product filter is active.

A healthy brand archive should open at its own URL, show products from that label, and display the description or banner if enabled. If the archive is empty, start by checking the product relationship rather than the template. Open one product, confirm the brand is selected, update the product, and open the archive again. If there are many products but the archive is empty for only one brand, check the slug and the product status.

Perfect WooCommerce Brands carousel on a WooCommerce page
A real example of brand output: a logo carousel and sidebar widgets help shoppers jump to the label they want.

What to do after changing the slug

After changing the slug, open Settings > Permalinks and click Save Changes. That refreshes the permalink rules. Then test one brand archive, the page with the brand list, a product page, and the filter. If the old URL was already getting traffic, set up a redirect to the new address using your SEO plugin or a server-level rule, but do not edit WordPress core or plugin files.

The SEO role of a brand page

A brand page can be a useful landing page if it contains products, a unique description, a clean banner, a clear heading, and proper pagination. But an empty page with one logo and two products rarely helps search visibility. For smaller brands, a short description and a strong filter experience are often enough. For key manufacturers, it makes sense to write dedicated copy, link to important categories, and make sure the page does not compete with a product category.

Do not turn the brand page into a duplicate of the category page. A category explains the type of product, while a brand page should help the shopper choose a manufacturer within that category. A good approach is to briefly explain the brand's specialization, show relevant products, link to the main groups, and give the shopper a clear path back into the catalog. A bad approach is copying the same manufacturer description onto every page and displaying an empty product list.

Shortcodes, carousels, and the A-Z brand list

One of Perfect WooCommerce Brands' strongest features is its ready-made shortcodes. They let you display brands not only in the standard archive, but also on the homepage, inside a landing block, in a post, on a manufacturer page, or inside a builder that supports shortcodes. The important part is not to drop them in blindly. Every shortcode should solve a specific job.

Logo carousel

A carousel works well on the homepage or at the top of the catalog if the store carries recognizable labels. Example from the documentation:

[pwb-carousel items="10" items_to_show="5" items_to_scroll="1" image_size="thumbnail" autoplay="true" hide_empty="true"]

The hide_empty parameter is especially important. When enabled, brands with no products will not appear in the output. That is good for a public storefront, but during troubleshooting it is worth temporarily setting it to false to confirm that the shortcode can see the brand at all.

Carousel of products from a specific brand

If you need to display products from a single label, use the product carousel by brand:

[pwb-product-carousel brand="brand-slug" products="10" products_to_show="5" products_to_scroll="1" autoplay="true"]

This is where users often get the slug wrong. The brand name and the slug are not the same thing. If the brand is called "My Shop," the slug may be my-shop. Check it under Products > Brands instead of copying it from the page title.

Brand-specific products through WooCommerce products

The plugin extends the standard WooCommerce product output with a brand parameter. This is convenient if you already use the WooCommerce product grid:

[products brands="brand-slug"]

If the shortcode is empty, check three things: the brand is assigned to products, the products are published, and you are using straight quotes " rather than typographic quotes inserted by a text editor. The plugin changelog has included fixes related to shortcode quotes, so it is safer to paste the code into a shortcode block or HTML block without automatic formatting.

Alphabetical catalog and an all-brands page

An A-Z listing is useful for stores with a large number of manufacturers. An "All Brands" page should function as a navigation page, not a warehouse of logos. Group brands alphabetically, hide empty ones, check the mobile layout, and avoid autoplay carousels where the user needs time to calmly find a name.

Perfect WooCommerce Brands shortcode map for store pages
It is best to place shortcodes by purpose: logos on the homepage, brand products on a landing page, and an A-Z list for a large catalog.

Brand filters in the catalog and widgets

The brand filter is one of the main reasons people install this plugin in WooCommerce. The shopper opens a category, selects a label, and sees only matching products. But the filter is useful only when it fits into the real buying flow: category, search, sorting, pagination, mobile navigation, and cache all need to work together.

Dropdown, list, and logos

A dropdown widget takes up little space and works well in a sidebar. A plain list of names is convenient when there are only a few brands. Logos look better visually, but they require a well-prepared media library. If logos come in different sizes, the page layout will jump around and the filter will start to look random. It is better to prepare the images up front than to try to repair everything with CSS after launch.

How to test the filter

Test the filter separately in the shop, inside a category, on search results, and after sorting. If the site uses an Ajax filter, a theme builder, or page caching, make sure it understands the pwb-brand taxonomy. Some filters are designed for attributes or WooCommerce's built-in product_brand taxonomy and may not pick up Perfect Brands data without extra configuration.

If the filter does not work, go back to the plugin's standard widget first and disable the third-party Ajax filter on a staging copy. That will show whether the issue is in the brand data or in the filter integration.

On mobile, the filter is often hidden inside a slide-out panel. Check more than just selecting a brand. Test clearing the filter, returning to the product list, and displaying the selected brand in breadcrumbs or the page heading. If the shopper cannot tell that a filter is active, they may think the store has too few products or is malfunctioning. In that case, a visible reset button and a clear active-filter label help a lot.

Practical scenario: a brand page for an electronics store

Imagine an electronics store that carries products from multiple manufacturers. The goal is to create a "Brands" page, add a carousel of popular labels to the homepage, display products from a chosen brand on a dedicated page, and enable a brand filter in the catalog. This is not an abstract example. It covers the plugin's core features and quickly shows whether it fits your store.

Preparation

Before you start, choose 5 to 7 test brands, prepare logos in a single format, and find 2 to 3 products for each label. Do not build the full manufacturer list right away. On the first pass, what matters is checking the mechanics: the brand is created, assigned to a product, displayed on the page, opens its archive, and participates in filtering.

Setup steps

  1. Create brands in Products > Brands and fill in the name, slug, description, and logo.
  2. Assign brands to test products through the metabox on the product edit screen.
  3. In WooCommerce > Settings > Brands, review the slug, logo size, and loop display.
  4. Create a "Brands" page and add an A-Z list or a block that displays all brands.
  5. Add a logo carousel to the homepage using hide_empty="true".
  6. For an important label, create a product block using [pwb-product-carousel].
  7. Add the brand filter widget to the shop sidebar.

Verifying the result

Open the public brands page. Each brand should have a logo or name, the link should lead to its archive, and the archive should contain only products from that label. Then open a product page and check whether the brand appears where you expected it. In the catalog, apply the brand filter and make sure pagination, sorting, and filter reset all work without odd jumps.

All brands page in Perfect WooCommerce Brands for WooCommerce
An all-brands page helps shoppers move from a familiar label to actual products instead of trying to find the manufacturer through a generic site search.

A practical nuance

If you can see the brand in the list but the archive is empty, do not rush to change the theme template. Check the product: is it published, does it have a category, is the correct brand selected, and is the product visible in the catalog? If the brand carousel is empty, temporarily disable hide_empty and make sure the shortcode can see the brands at all.

How to verify the setup after configuration

Verification should follow the chain "data - settings - public-facing output - integrations." If you look only at a nice carousel, you may miss a broken archive. If you look only at the archive, you may fail to notice that the filter does not work in search. For a store, the entire user path matters.

After the first launch, save a short operating checklist for editors. It should explain how to add a new brand, what logo size to use, who approves the slug, where to review the brand page, and how to decide that a brand is ready to be shown publicly. This is especially important in stores where products are added by managers rather than developers.

Post-setup verification checklist
CheckWhere to lookExpected result
Brand assigned to a product Products > Edit Product The correct label is selected in the metabox.
Brand archive opens Public brand link The page does not return a 404 and shows products.
Logo is not blurry Carousel, list, product page The image is readable on desktop and mobile.
Shortcodes are not empty Page with brand blocks The carousel and brand products display the expected content.
Filter works with the catalog Shop, category, search After selecting a brand, the product set narrows without breaking pagination.
Cache is not showing stale data Incognito mode, another browser, cleared cache New brands appear without a manual page refresh.

If the store is multilingual, also check translated brand names, URLs, and SEO titles. If you use Google Listings & Ads or another product feed tool, do not assume synchronization happens automatically. Verify which brand taxonomy the specific tool actually reads.

How to maintain the brand catalog after launch

Once the initial setup is done, the work does not end. New products keep coming in, suppliers change, some brands disappear from the assortment, and some manufacturers require updated logos or descriptions. Without clear rules, the brand catalog turns into a mix of duplicates, empty pages, and outdated images within a few months.

Operating rules for catalog managers

The person adding a product needs to understand that brand is not a free-text field. Before creating a new label, they should search for an existing brand under Products > Brands, check the spelling, slug, and logo. If the brand already exists, it should be selected on the product page, not recreated. If it does not exist, create it using one consistent rule: a clean name, a Latin-character slug, a proper logo, a short description, and a check of the public-facing page.

It also helps the team to keep a simple control table. Columns such as brand name, slug, who added it, whether it has a logo, whether it has a banner, how many published products it has, and whether SEO work is needed are enough. This table does not replace WooCommerce, but it helps you spot problems before the customer does. For example, if a brand has a beautiful banner but no products, that page probably should not be promoted yet.

Empty and archival brands

A brand can become empty for perfectly normal reasons: products are discontinued, a supplier leaves, or inventory sells out. In those cases, deleting the term is not always the best move. If the brand page has already been indexed or has internal links pointing to it, removing it may create unnecessary errors. First decide what matters more: keeping it as an informational page, hiding it from carousels with hide_empty, or redirecting it to a relevant category.

An empty brand in the admin area is not automatically a problem, but an empty brand in public navigation almost always hurts the shopping experience. That is why empty brands are best hidden from customer-facing pages while being left in the admin area until an editorial decision is made. This is especially useful for seasonal products and stores where inventory changes in batches.

Logo and banner quality control

Every few months, review the all-brands page and your carousels. Look for logos with mismatched backgrounds, images that are too small, unreadable marks, cropped banners, and brands with no description. These issues may not break the site technically, but they make the storefront feel less polished. If the brand matters, prepare a dedicated archive banner. If the brand is secondary, a good logo and a short description are usually enough.

After replacing logos, clear the image cache, page cache, and CDN if one is in use. Then open the site in a private window. If the old image still appears, the cause may not be Perfect Brands at all, but your image optimizer or an external cache. In that case, do not change plugin settings at random. Check the entire image delivery chain.

Brand migration and coexistence with WooCommerce Product Brands

The riskiest scenario is not a new installation, but a store where brands already exist in another form. That might be the pa_brand attribute, WooCommerce's built-in product_brand taxonomy, an older brand plugin, or a custom theme implementation. On the surface, all of them may be called Brands, but technically they are different data stores. Perfect WooCommerce Brands works with its own taxonomy, so the transition should be planned as a data migration, not as a visual redesign.

How to tell where the current brands live

Open a few products and look at where the brand is selected. If it appears under attributes, you are probably dealing with a product attribute. If it appears in a dedicated Brands block from WooCommerce, check whether it uses product_brand. If the menu item leads to a URL containing taxonomy=pwb-brand, that is Perfect Brands. For a precise answer, a developer can inspect the database, but for a typical editor the screen URL and filter behavior are often enough.

Do not migrate data with direct SQL queries unless you clearly understand the difference between terms, product relationships, logo metadata, and permalinks across several WordPress tables. One mistake can produce strange results: the brand exists but the logo is gone, the product is linked but the archive is empty, or the filter shows the term but finds no products.

Safe step-by-step migration

  1. Back up the database and the media library.
  2. Record the current URLs of your key brands and their traffic sources.
  3. On a staging copy, identify the source brand taxonomy.
  4. Migrate a small set of brands and products instead of the full catalog.
  5. Check logos, archives, filters, shortcodes, and product pages.
  6. Set up redirects for any URLs that changed.
  7. Only then repeat the migration for the full catalog.

If your store already runs well on WooCommerce's built-in Product Brands, you do not necessarily need to move everything into Perfect Brands just to get a carousel. In some cases, it makes more sense to add a separate display block or choose a tool that supports your current taxonomy.

When two brand systems can temporarily coexist

Sometimes, during a transition, you may need to keep two systems alive. For example, legacy pages may run through Perfect Brands while a new supplier import delivers brands into product_brand. That setup is acceptable only as a temporary state. On the public side, the user should never see two different Brands filters, two pages for the same manufacturer, or multiple URLs for the same label. Choose one primary system and use the second one only for migration or internal data handling.

If you keep both systems permanently, editors will start assigning products in different places, SEO pages will begin competing with each other, and filters will return incomplete results. Your final plan should answer three questions: which taxonomy remains primary, which URLs are canonical, and which import tools will be used going forward.

If the brand is not displaying, the filter is silent, or the URL returns a 404

Troubleshooting brands in WooCommerce should not be based on guesswork. It should be based on systematically ruling out causes. Start with the simplest checks: does the brand exist, is it assigned to a product, is the product published, and have permalinks been resaved? Only then move on to the theme, cache, third-party filters, and taxonomy conflicts.

CodeCanyon Perfect WooCommerce Brands error diagnostics
A diagnostic map helps separate a data problem from a URL conflict, cache issue, theme issue, or third-party filter conflict.

The brand page returns a 404

Symptom: the brand is created, the link exists, but the public page will not open. Possible causes include permalink rules not being refreshed, the slug conflicting with a page or WooCommerce's built-in brands, another brand plugin being active, or cache holding on to the old route.

What to do: open Settings > Permalinks, click Save Changes, clear cache, and test one archive. If the problem started after enabling WooCommerce Product Brands, compare the URL bases used by both systems and choose a unique slug. If old links are already indexed, set up a redirect.

There are two Brands items in the admin area

Symptom: two similar Brands items appear under Products. That usually points to two brand systems: Perfect Brands and WooCommerce's built-in feature or another plugin. Do not start deleting terms at random. Hover over the menu item or open it and inspect the URL. For Perfect Brands, the important taxonomy is pwb-brand. WooCommerce uses a different one.

The shortcode outputs nothing

Check the brand slug, straight quotes, product availability, and the hide_empty parameter. If you are using the block editor, insert the shortcode into a dedicated shortcode block instead of a formatted paragraph. If the shortcode works on one page but not inside a page-builder template, the issue may be how the builder processes shortcodes.

The logos look bad

The cause is not always the plugin. More often, the logos were uploaded in different proportions, without transparent backgrounds, with too much empty padding, or at a very small size. Normalize the source files to one consistent height, review Brand logo size, and do not upscale tiny images with CSS. For a carousel, a smaller number of brands with clean logos is better than a long strip of mismatched images.

Errors appeared after an update

The plugin changelog includes fixes related to WooCommerce compatibility, PHP, translations, and security. If a problem appeared after an update, check the error log, the WooCommerce version, the active theme, and the list of plugins. On a live site, a temporary rollback is acceptable only to the most recent known-good version. Do not roll back below a release that fixed a known security issue if the plugin will remain enabled.

For sites with authors, editors, and store managers, it is important to limit shortcode insertion permissions and keep the plugin updated. Older releases before the fixed branch had a known issue in the way parameters were processed.

The best place to test updates is a staging copy with real products and brands. An empty test installation will not reveal conflicts with an old slug, a custom product template, or a third-party filter. After an update, go through the same checklist again: brand archive, product page, shortcodes, filter, mobile view, and error log.

Safe improvements without editing plugin files

For Perfect WooCommerce Brands, the built-in settings, shortcodes, and careful image preparation are usually enough. Code is rarely necessary. If you need to change the appearance, start with CSS in a child theme or through a trusted snippet manager. If you need template changes, use the theme template override mechanism described in the developer docs and keep your changes separate from the plugin files.

When CSS is appropriate

CSS makes sense if you need to align logos, adjust spacing in a carousel, or make the brand list more compact. It should not be used to hide bad data. For example, if logos jump around because their proportions differ, fix the media library first and use CSS only for final alignment.

.pwb-brands-cols-outer img {
  max-height: 80px;
  object-fit: contain;
}

The test is simple: open the brands page, a product page, and the mobile view. If the CSS hurts readability or crops the logos, remove the rule from the child theme or disable the snippet.

When it is better not to write code

Do not write SQL migrations by hand unless you fully understand the difference between the pwb-brand, product_brand, and pa_brand taxonomies. Do not edit plugin files just to rename a tab or adjust a template. Those changes will disappear after an update and make troubleshooting harder. For a complex migration, a staging copy, export, compatible import, and a database backup are the better path.

Perfect WooCommerce Brands FAQ

Where are the main settings located?

Official sources point to WooCommerce > Settings > Brands. That is where you review the slug, logo sizes, brands page, loop display, brand page behavior, and developer tools.

What should I do if brand pages return a 404?

Start by resaving Settings > Permalinks. Then check whether the brand slug conflicts with WooCommerce Product Brands, the /brands/ page, a category, or another plugin. If you change the slug on a live site, plan your redirects in advance.

Can I use the plugin together with WooCommerce's built-in brands?

Technically, a site can contain multiple taxonomies, but that raises the risk of confusion. For a new store, it is better to choose one system. For an older store already using Perfect Brands, first identify which pages and filters already depend on pwb-brand.

Why does the shortcode output an empty block?

In most cases, the wrong slug was entered, the brand has no published products, hide_empty is enabled, the shortcode was pasted with typographic quotes, or the page builder does not execute shortcodes inside the selected widget.

Can I import brands from another site?

The documentation describes export and import through brands.json. That is convenient for moving Perfect Brands data between sites, but it does not replace checking products, images, slugs, and taxonomies. Always run the import on a staging copy first.

Does the plugin affect store performance?

Brand output by itself is usually lighter than complex filters, but large carousels, all-brands lists, product counts, and third-party Ajax filters can add extra queries and scripts. Limit the number of elements, hide empty brands on public pages, and test the catalog under real load.

Do I need the paid version?

Sources differ between the old CodeCanyon page, WordPress.org, and the current QuadLayers page. So do not rely on outdated wording. Review the current feature set on WordPress.org, QuadLayers, and in the changelog, then decide whether the free feature set is enough for your storefront.

When CodeCanyon Perfect WooCommerce Brands is a strong choice

CodeCanyon Perfect WooCommerce Brands is a strong fit for stores where brand is a real navigation path rather than a decorative field. If shoppers search by manufacturer, and if you need logos, brand pages, filters, carousels, and product output for a specific label, the plugin solves a clear problem. It is especially useful when you are ready to curate the brand data carefully and verify how it behaves on the public-facing site.

Before installing it on a live store, check compatibility with WooCommerce Product Brands, permalinks, the theme, caching, and third-party filters. After installation, walk through a small scenario with one brand and one product before migrating the full catalog. If everything works on a staging copy, you can get the WordPress version and move on to careful setup on your own site.

The main decision criterion is simple: if brands improve product discovery and help shoppers decide faster, the plugin is worth testing. If brand navigation only duplicates categories, is not supported by your theme, or conflicts with the WooCommerce setup you already have, clean up the catalog structure first and only then add another layer.

By OceanTheme.org Editorial Team

 

You are not logged in to post comments.