---
title: "YOOtheme Builder integration"
date: 2026-07-24
author: "Claude MCP"
---

# YOOtheme Builder integration

**YOOtheme Builder integration** is only available in the PRO version.  
Unlock this and other features by upgrading to **Joomill Price List PRO**  
  
[Go PRO](https://www.joomill-extensions.com/subscribe/order/product/price-list-pro)

 If your site uses a YOOtheme Pro template, Price List PRO adds itself as a data source in the YOOtheme Builder. No setup is required, it's detected automatically once both are installed.

 
## Two ways to use it

 
### 1. Restyle the built-in pages with the Customizer

 Open YOOtheme's **Customizer** and choose a template for the Price List **product**, **category**, **categories** or **multiple** view, exactly like you would customize a Joomla article or category template. You design the layout visually with the Builder, using the item's own data.

 
### 2. Add a price list to any page

 In the Builder, add the **Joomill Price List Table** element (search for "Price List" in the element picker). It renders as a table with a row per item, and comes with the same style options as YOOtheme's other table-based elements: table style, column widths, title/meta/text styles, image and link button.

 Set the element's **Source** to one of the Price List data sources, then bind each column of the child **Item** element to a product field via the dynamic content picker.

 
## Available data sources

 
- **Products**: the products of the category currently being viewed. Only works on a category page.
- **Custom Products Query**: an independent list you filter yourself: by category (one or more), featured only, order by (default order, name, price or date added), direction, and a start/limit for pagination.
- **Custom Categories Query**: a filtered list of categories, for example to build your own category overview.
- **Category → Products**: nested under a category source, useful for grouping products per category yourself.

 
## Available product fields

 ID, Name, Description, Price, Category ID, Featured (0/1), Language, Start publishing, Finish publishing, and Link to product. Category sources expose ID, Title, Alias, Description and Link to category.

 Products don't have a native image field. If you want an image per item, add a Media custom field on **Components > Price List > Fields**, see "Custom Fields", it becomes available as a bindable field automatically, alongside any other custom field you've added.

 
## Example: a category overview with product tables

 This example builds a page that lists every category with its own table of products underneath, using only Builder elements, no coding required.

 
1. Add a **Section** element to the page.
2. Open the section's Dynamic Content settings and set the source to **Custom Categories Query**. The section now repeats once for every category that matches your filters.
3. Inside the section, add a **Title** element and bind it to the category's **Title** field, then add a **Description** element underneath and bind it to the category's **Description** field. Each repeated section now shows its own category name and description.
4. Below the title and description, add the **Joomill Price List Table** element. Open its Dynamic Content settings, set Parent to **Section**, the type to **Multiple Items**, and the source to **Products**. Because the table's parent is the section that's already showing one category at a time, it automatically lists that category's products, you don't pick a category yourself here.
5. In the table's **Item** element, bind the content fields: **Title** to the product's **Name**, **Text 1** to the product's **Description**, and **Text 2** to the product's **Price**.

 Save and preview the page. Every category now shows its own heading, description, and a table of its products underneath.

 
## What visitors see

 These sources follow the exact same visibility rules as the rest of the site: a product only appears if it's published, its scheduled publishing dates (if any) are active, and both the product's and its category's access level allow the current visitor to see it. There's nothing extra to configure, if an item is hidden here, check the same things as in "Troubleshooting & FAQ".