Catalog theme integration

The catalog offers several ways to integrate it with your theme. You choose the method in Products > Settings > General Settings, in the Catalog Layout Integration section.

Shortcode or block integration

Shortcode integration is enabled by default for most of the themes. If you place the [show_product_catalog] shortcode or the Show Catalog block on your main catalog page (this page is selected in the Main Catalog Page setting), the layout for all the catalog pages will be the same as the one defined for the main catalog page.

You can even use a page builder to build the layout of the catalog with the shortcode integration. The shortcode will always be replaced with the correct content for the currently viewed catalog page, but all other text/HTML placed on the main catalog page will be the same for all catalog pages.

Catalog templates in block themes

With a block theme on WordPress 6.7 or newer, you can edit the Main Catalog Page, Single Catalog Page and Catalog Category Page templates in the Site Editor. See Product Page Blocks and Catalog Templates.

Template file integration

The template file integration is for advanced users with access to the website FTP. You can place the product-adder.php file inside your child theme folder to fully control the catalog layout.

The best way to start is to copy your theme page.php content to the product-adder.php and replace the default loop code with the content_product_adder() function. The content_product_adder() function will always show the currently viewed catalog page content.

You can read more about this integration method inside the theme integration guide.

Advanced Theme Integration wizard

The wizard method can be used without the [show_product_catalog] shortcode and the product-adder.php file. When you remove the shortcode from your main catalog listing page, you should go to the general catalog settings.

You will find the Catalog Layout Integration section (it shows up only if the product-adder.php is not in the theme folder) at the top of the settings screen. The section can look like this:

or like this:

Select Advanced Mode in the Layout mode setting and click the wizard button to proceed.

You can read more about this integration method inside theme integration wizard docs.

Simple theme integration

This method can be used without the [show_product_catalog] shortcode and the product-adder.php file.

When you remove the [show_product_catalog] shortcode from the main catalog page, the catalog will automatically switch to the simple mode. You can check if the simple mode is enabled in the catalog general settings theme integration section:

Simple Mode is the recommended layout mode. The catalog takes your theme page template and applies the catalog styling to it. The product listing, product search and category pages are disabled in this mode, so it’s useful if you don’t want the category pages to appear automatically.

Theme Mode

Select Theme Mode in the Layout mode setting if your theme should control the layout. Your theme’s default template files are then used to display the catalog pages.