> For the complete documentation index, see [llms.txt](https://ovatheme.gitbook.io/brw/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ovatheme.gitbook.io/brw/brw-menu/categories.md).

# Categories

What categories do and how they relate to products

#### What is a BRW Category?

BRW Categories are WordPress taxonomy terms (`ovabrw_cat`) that group rental products. Beyond just grouping, each category carries its own settings that **override plugin-level defaults** for any product in that category. This allows you to have different display modes, price formats, label text, and templates per product group.

1. The standard WordPress fields (Name, Slug, Parent, Description, Thumbnail) appear at the top of the form automatically.
2. All BRW-specific fields documented below appear underneath them.
3. Settings left at their default/empty value inherit from WooCommerce → Settings → Booking & Rental.

{% hint style="info" %} <mark style="color:$primary;">**Priority:**</mark> <mark style="color:$primary;"></mark><mark style="color:$primary;">Product-level settings → Category-level settings → Plugin global settings. A value set on the product itself always wins. If empty, the category value is used. If that is also empty, the plugin global applies.</mark>
{% endhint %}

<figure><img src="/files/FdecpwfJ4cEI3JDUIhud" alt=""><figcaption></figcaption></figure>

### **1: Display**

Archive page layout for products in this category

#### Display

Controls which archive template is used when a customer views the listing page for this category.

| Value    | Description                                                |
| -------- | ---------------------------------------------------------- |
| `shop`   | Standard WooCommerce shop/grid layout                      |
| `rental` | BRW custom rental listing layout (with map, filters, etc.) |

{% hint style="warning" %} <mark style="color:red;">**Note:**</mark> <mark style="color:red;"></mark><mark style="color:red;">This only affects the category archive page. The global default is set at WooCommerce → Settings → Booking & Rental → Product Archive → Display Shop Page.</mark>
{% endhint %}

### 2: Display Price In Format (product template)

Price string shown on the single product page for products in this category

#### Price Format Type (Product Page)

Choose whether to inherit the global setting or define a custom format just for this category.

| Value    | Description                                                                                                     |
| -------- | --------------------------------------------------------------------------------------------------------------- |
| `global` | Use the format defined in WooCommerce → Settings → Booking & Rental → Product Details → Display Price In Format |
| `new`    | Use the custom format entered in the textarea that appears below                                                |

#### Custom Price Format (Product Page)

{% hint style="warning" %}
Visible only when Price Format Type =**New format**
{% endhint %}

Enter a custom price string using text, HTML, and any of the following shortcodes:

{% columns %}
{% column %}

```
Day / Night / Hour / Km / Mi

[regular_price]
Base price per day

[hour_price]
Base price per hour

[min_daily_price]
Min nightly/daily rate

[min_price]
Min Appointment slot price

[max_price]
Max Appointment slot price
```

{% endcolumn %}

{% column %}

```
[max_daily_price]
Max nightly/daily rate

[min_package_price]
Min Period package price

[max_package_price]
Max Period package price

[min_location_price]
Min Transportation price

[max_location_price]
Max Transportation price

```

{% endcolumn %}
{% endcolumns %}

{% hint style="success" %}
**Example:** `From [regular_price] / [unit]` → "From $50 / Day"
{% endhint %}

### **3:** Display Price In Format (card template)

Price string shown on archive/listing cards for products in this category

#### Price Format Type (Card)

Same logic as the product page format — choose `global` to inherit from plugin settings, or `new` to define a category-specific format.

| Value    | Description                                                                                      |
| -------- | ------------------------------------------------------------------------------------------------ |
| `global` | Inherits from WooCommerce → Settings → Booking & Rental → Product Archive → Archive Price Format |
| `new`    | Custom format entered in the textarea below                                                      |

#### Custom Price Format (Card)

{% hint style="warning" %}
Visible only when Price Format Type =**New format**
{% endhint %}

Custom price string for product cards in the listing/archive. Uses the same shortcodes as the product page format above.

### 4: Choose Custom Taxonomies

Link custom taxonomy filters to this category in the search form

#### Custom Taxonomies

{% hint style="warning" %}
Only visible when "Show Taxonomy Depending On Category" = Based on each category (General Settings)
{% endhint %}

Select which custom taxonomy filters (created under BRW → [Custom Taxonomies](/brw/brw-menu/custom-taxonomy.md)) are associated with this category. When a customer selects this category in the search form, only these taxonomy filters will appear.

{% hint style="info" %}
**Prerequisite:** You must first create taxonomy terms in **BRW → Custom Taxonomies** and enable them. Then return here and assign them to the appropriate categories.\
\
**Global setting:** WooCommerce → Settings → Booking & Rental → General → Custom Taxonomy → *Show Taxonomy Depending On Category*. If that is set to "All", this field is hidden and all taxonomies show regardless of category.
{% endhint %}

### 5: Choose Custom Checkout Fields

Control which custom checkout fields appear for products in this category

#### Custom Checkout Fields Type

Decide which custom checkout fields to show during checkout for bookings in this category.

Default: all

| Value     | Description                                                           |
| --------- | --------------------------------------------------------------------- |
| `all`     | Display all enabled custom checkout fields (same as global behaviour) |
| `special` | Show only the specific fields chosen in the multiselect below         |

#### Select Custom Checkout Fields

{% hint style="warning" %}
Visible only when Type =**Choose other fields**
{% endhint %}

Pick the specific custom checkout fields that should appear at checkout for products in this category. Fields are listed as *Label (slug)*. The order in which you select them determines the display order at checkout.

{% hint style="warning" %}
**Prerequisite:** Custom checkout fields must be created BRW → [Custom checkout Fields](/brw/brw-menu/custom-checkout-fields.md) and enabled in BRW → Settings → Booking Form before they appear in this list.
{% endhint %}

### 6: Choose Specifications

Control which specification rows display on products in this category

#### Specifications Type

Determine which specification rows appear in the Specifications section on product pages in this category.

Default: all

| Value     | Description                                        |
| --------- | -------------------------------------------------- |
| `all`     | Show all enabled specifications globally           |
| `special` | Show only the specific specifications chosen below |

#### Select Specifications

{% hint style="warning" %}
Visible only when Type =**Choose other fields**
{% endhint %}

Choose which specification fields appear on products in this category. Useful for differentiating specifications between, for example, a Car category (Seats, Fuel Type, Transmission) and a Boat category (Length, Engine, Capacity).

{% hint style="warning" %}
**Prerequisite:** Specifications must be defined BRW →[Specifications](/brw/brw-menu/specifications.md) and enabled in BRW → Settings → Specifications before they appear here.
{% endhint %}

### 7: Show Location in Form

Override which location fields appear in the booking form for this category

#### Show Location in Form

Choose which location fields are displayed in the booking form for products in this category. Leave empty to inherit the global setting.

| Value         | Description                      |
| ------------- | -------------------------------- |
| `pickup_loc`  | Show the Pick-up Location field  |
| `dropoff_loc` | Show the Drop-off Location field |

{% hint style="info" %}
**Global fallback:** WooCommerce → Settings → Booking & Rental → Product Details → Booking Form → Show Pickup/Dropoff Location.
{% endhint %}

### **8:** Rename Date Labels

Override the booking form date field labels for this category

#### Rename "Pick-up Date" Title

Custom label for the start-date field in the booking form. Leave empty to use the default "Pick-up Date" label.\
**Example:** *Check-in*, *Departure Date*, *Start Date*

#### Rename "Drop-off Date" Title

Custom label for the end-date field.\
**Example:** *Check-out*, *Return Date*, *End Date*

{% hint style="info" %}
**Use case:**&#x20;

Hotel category → rename to "Check-in / Check-out".&#x20;

Tour category → rename to "Departure Date / Return Date".&#x20;

These labels appear in the booking form, order details, and admin columns.
{% endhint %}

### **9:** Rename Location Labels

Override the booking form location field labels for this category

#### Rename "Pick-up Location" Title

Custom label for the pickup location field. Leave empty to use the default "Pick-up Location".\
**Example:** *Departure Location*, *Start Point*, *From*

#### Rename "Drop-off Location" Title

Custom label for the drop-off location field.\
**Example:** *Return Location*, *End Point*, *To*

### 1&#x30;*:* Product Template

Override the single product page template for this category

#### Product Template

Select a specific Elementor page template for products in this category. The dropdown is populated from **Elementor → Templates → Pages**.

Default: Global Setting

| Value                        | Description                                                                                                |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------- |
| *(empty / Global Setting)*   | Use the template defined in WooCommerce → Settings → Booking & Rental → Product Details → Product Template |
| *\[Elementor Template Name]* | Use that specific Elementor page template for all products in this category                                |

{% hint style="warning" %}
**Note:** The template currently set as "Global Setting" in the plugin settings is excluded from this list to avoid confusion. Only non-global templates appear.
{% endhint %}

{% hint style="info" %}
**Elementor required:** This field only lists templates if the Elementor plugin is active and has saved Page templates. For non-Elementor sites, use the Classic/Modern global setting instead.
{% endhint %}

### **11:** Card Template

Override the product card layout in the listing/archive for this category

#### Card Template

{% hint style="warning" %}
Only visible when Typography & Color is enabled in plugin settings
{% endhint %}

Choose which card design is used when products in this category appear on archive/listing pages. Available card templates are defined by the BRW plugin's built-in card variants.

Default: Global Setting

| Value                      | Description                                                                                        |
| -------------------------- | -------------------------------------------------------------------------------------------------- |
| *(empty / Global Setting)* | Use the card template set in WooCommerce → Settings → Booking & Rental → Typography & Color → Card |
| *\[Card variant name]*     | Override with a specific card layout for products in this category                                 |

{% hint style="warning" %} <mark style="color:red;">**Prerequisite:**</mark> <mark style="color:red;"></mark><mark style="color:red;">This field only appears when</mark> <mark style="color:red;"></mark><mark style="color:red;">**Enable Global Typography & Color**</mark> <mark style="color:red;"></mark><mark style="color:red;">is checked in WooCommerce → Settings → Booking & Rental → Typography & Color.</mark>
{% endhint %}

### **12: Add Category to menu**

Go to Appearance >> Menu >> Choose Product Categories to add it to menu

<figure><img src="/files/YGN4Fok15i69wJOrtkA5" alt=""><figcaption></figcaption></figure>