WP Bra Calculator
Plugin Documentation
v2.0.0
Official Plugin Documentation

WP Bra Calculator

The complete guide to installing, configuring, and customizing the WP Bra Calculator - the most powerful bra size calculator plugin for WordPress & WooCommerce.

Version 2.0.0 WordPress 6.0+ PHP 8.1+ WooCommerce Optional Updated June 2026

Introduction

WP Bra Calculator is a powerful, fully customizable WordPress plugin that helps women find their correct bra size using an interactive, step-by-step measurement calculator. It takes underbust (band) and bust (overbust) measurements and returns accurate size recommendations complete with country-specific sizing charts.

With its deep WooCommerce integration, matched bra products are automatically shown to customers after they calculate their size - dramatically improving conversion rates for lingerie and apparel stores.

Visual Size Builder

Create unlimited size charts with country-specific band, cup, and overbust ranges.

WooCommerce Integration

Show matched products on product pages or calculator results automatically.

Flexible Styles & Colors

Two calculator layouts, two result styles, and full brand color control.

Import / Export

Back up and restore all settings with one click. Move between sites instantly.

Custom Code Injection

Add custom CSS and JS directly from the admin - no file editing needed.

Automatic Updates

License-protected updates delivered directly inside WordPress admin.

Requirements

Before installing, ensure your server meets the following requirements:

Requirement Minimum Recommended
WordPress 6.0 Latest stable
PHP 8.1 8.2 or 8.3
MySQL 5.7 8.0
WooCommerce Optional - required only for WooCommerce features
License Key Required to unlock all features after installation

PHP 8.1 Strict Requirement

WP Bra Calculator uses modern PHP features including strict types, named arguments, and typed properties - available only in PHP 8.1+. The plugin will automatically deactivate if your PHP version is lower.

Installation

1

Download the Plugin ZIP

After purchase on CodeCanyon, download the Installable WordPress files only ZIP from your Downloads page. File is named wp-bra-calculator.zip.

2

Go to Plugins → Add New

In your WordPress admin, navigate to Plugins → Add New Plugin → Upload Plugin.

3

Upload the ZIP File

Click Choose File, select the downloaded ZIP, then click Install Now.

4

Activate the Plugin

Click Activate Plugin. A new Bra Calculator menu item will appear in the sidebar.

5

Activate Your License

Go to Bra Calculator → License & Updates and enter your purchase license key to unlock all features.

Do Not Upload the "All Files" Bundle

If you downloaded the "All files & documentation" archive from CodeCanyon, extract it first. Use only the inner wp-bra-calculator.zip for WordPress installation.

Quick Start Guide

Under 5 minutes

Follow these steps after installation to get the calculator live on your site in under 5 minutes.

1

Activate Your License Key

Navigate to Bra Calculator → License & Updates. Enter your purchase code and click Save License. Status shows Licensed on success.

2

Create Your First Size Chart

Go to Bra Calculator → Size Builder → click Create First Size Chart. Select countries, add band measurement rows, add cup columns, and click Save Chart.

3

Configure the Setup Tab

Go to Bra Calculator → Setup. Select the size chart you just created, set your page title, add measurement images, and save.

4

Place the Shortcode

Create or edit any WordPress page and paste the shortcode below. Publish the page - your calculator is now live!

[bra_calculator]
5

Customize Appearance (Optional)

Go to Bra Calculator → Settings to choose your calculator layout, result box style, and brand colors.

Shortcode

WP Bra Calculator uses a single shortcode to embed the interactive calculator anywhere on your site:

Shortcode

[bra_calculator]

Place anywhere - pages, posts, widgets, page builders, or PHP templates

Where You Can Use It

Platform / Location How to Add
Gutenberg Add a Shortcode block and paste the shortcode.
Classic Editor Paste directly in the text area.
Elementor Use the Shortcode widget.
WPBakery / Divi Use a Raw HTML or Code module.
PHP Template <?php echo do_shortcode('[bra_calculator]'); ?>

Pro Tip: Create a dedicated WordPress page named "Find My Bra Size" for the calculator. Then link to it from your WooCommerce product pages using the WooCommerce tab's Button Link setting.

Setup Tab

Bra Calculator → Setup

The Setup tab is the main configuration panel for the calculator's text content, measurement instructions, and size chart selection.

A Page Titles

Field Default Value Description
Page Title MEASURE YOUR BAND SIZE Main headline displayed above the calculator steps.
Page Sub Title Our Bra Size Calculator Can Help... Subtitle shown below the main title.

B Band Size - Step 1 (Underbust)

Field Description
Step Title Step label shown to the user (e.g., "STEP-1:")
Heading Text Bold heading for this step (e.g., "UNDERBUST SIZE")
Measurement Title Dropdown placeholder text
Description Instructional text explaining how to measure underbust
Image Upload an illustration (600×600 px recommended). Preview shown on right.

C Button Text & Result Heading

Field Default Description
Button Text CLICK TO CALCULATE Label on the main call-to-action button.
Result Heading YOUR RECOMMENDED BRA CUP Size Is Text displayed above the calculated size result.

Click Save Settings at the bottom right to persist all changes. Click Reset to restore factory defaults for this tab only.

Size Builder Tab

Bra Calculator → Size Builder

The Size Builder is the core engine of WP Bra Calculator. Create unlimited size charts that map band measurements to cup sizes for specific countries.

1

Select Countries

Choose which countries this chart applies to

2

Define Size Ranges

Set band & bust measurement ranges

3

Activate the Chart

Enable & select in Setup tab

Creating a Size Chart Step-by-Step

1

Click "Add Size Chart" or "Create First Size Chart"

If no charts exist, you'll see a prompt. Click the button to open the chart editor.

2

Select Countries

Use the searchable multi-select dropdown to choose countries this chart applies to (e.g., US, UK, AU). Multiple countries can be assigned.

3

Add Size Rows (Underbust Ranges)

Click + Add Size Row. Set From-To underbust values and assign a size label (30, 32, 34...).

4

Add Cup Columns (Overbust Ranges)

Click + Add Cup Column. Label each column (A, B, C, D...) and fill in overbust From-To per row. Smart Validation ensures sequential, non-overlapping ranges.

5

Save & Activate

Click Save Chart. Then toggle the chart status to Active and select it in Setup → Size Chart.

Smart Validation is Active
"To" value must be greater than "From"
Each new range must start above the previous
New rows unlock after current row is complete

Settings Tab

Bra Calculator → Settings

Controls the visual presentation of the calculator and its results - measurement units, layout styles, and brand colors.

Measurement Unit

Controls which measurement units appear in the calculator dropdowns. Click to preview each option.

Measurement Layout

Visual style for the measurement input steps shown to the customer.

Result Box Layout

How the calculated bra size result is displayed after clicking Calculate.

Appearance Colors

Three color groups — each with a Background and Text color picker — control the visual brand of the calculator.

Color Group Field Default Applied To
Subtitle, Step & Result Box Background #000000 Step boxes & result panel background
Text #f5a30a Text inside step boxes & result headings
Button & Slider Background #f5a30a Calculate button & slider track
Text #ffffff Label on the Calculate button
Style 2 Measurement Header Background #000000 Header row bg (Style 2 only)
Text #ffffff Header row text (Style 2 only)

Global colors apply to instances using settings="default". Instances with settings="custom" in the shortcode use their own inline color attributes and ignore these settings.

WooCommerce Tab

Bra Calculator → WooCommerce

Connect the bra size calculator to your WooCommerce store for a seamless shopping experience.

WooCommerce Integration

Attach the calculator result to WooCommerce product actions.

Enable Disable

When enabled, all WooCommerce features below become active. When disabled, no WooCommerce elements are shown.

Button & Link Settings

Field Description
Button Title Label for the "Measure Bra Size" button shown on WooCommerce product pages.
Button Link Type Link to a WordPress Page (page selector) or a custom URL.
Products Section Badge Badge label above matched products (default: "Product Matches").
Products Section Heading Heading above matched products list (default: "Top related bras for your size").
See All Button Label Label for link to view all matched products.
Products Limit Maximum matched products to display - range: 1 to 8 (default: 4).

Logic Block — Matched Product Engine

Setting Options Description
Search related products Enable / Disable Show WooCommerce products matching the calculated size after calculation.
Product Size Source Custom / Variation Custom — matches by chart size labels (e.g., "32B"). Variation — matches by WooCommerce product variation attribute values.
Button Display Mode Show to All / Show if / Hide if Controls which WooCommerce product pages show the "Measure Bra Size" button. Configure with Logic Rules below.
Logic Relation AND / OR When multiple Logic Rules are added: AND = ALL rows must match. OR = ANY single row match triggers the action.

Logic Rules — Shopify-Style Advanced Product / Category / Tag Picker

Logic Rules give you granular control over which WooCommerce product pages show or hide the calculator button. The value picker performs a live AJAX search of your WooCommerce data as you type — identical to Shopify's product picker.

Button Display Modes

Rule Anatomy: Field + Operator + Value

Each rule row is a 3-part condition. The Value field is a searchable, multi-select live picker — type any product name, category, or tag to search and select it instantly.

Part Available Options What It Does
Field Product   Category   Tag What type of thing to match against: a specific product, a product category, or a product tag.
Operator Is in   Is not in Is in — the current product belongs to the selected value. Is not in — the current product does NOT belong to the value.
Value Live-search picker (multi-select) Queries your WooCommerce database via AJAX as you type. Results appear instantly. Select multiple items — each shows as a removable chip tag.
How the Shopify-Style Live Picker Works
Live AJAX SearchType in the value field — results from WooCommerce appear immediately. No page reload required. Shows name + ID.
Multi-Select ChipsSelect multiple items per rule. Each selection becomes a removable chip tag. One rule can match a list of products/categories.
Multiple Rule RowsClick + Add Rule for additional conditions. All rows combined using the AND/OR Logic Relation setting.
Server-Side EvaluationRules are evaluated server-side on each product page load — zero front-end performance impact.

Practical Examples

Use Case Mode Rule Configuration
Show on all bra products Show If Field: Category Op: Is in Value: Bras
Hide on all accessories Hide If Field: Category Op: Is in Value: Accessories
Show on 2 specific products Show If Field: Product Op: Is in Value: [search & select both]
Show only for "lingerie" tag Show If Field: Tag Op: Is in Value: lingerie
Bras category but not sale items (AND) Show If Row 1: Category Is in Bras  &  Row 2: Tag Is not in sale | Relation: AND

Custom Code Tab

Bra Calculator → Custom Code

Inject custom CSS and JavaScript into the public calculator without editing any theme or plugin files.

Custom CSS

Enter plain CSS rules. Do not include <style> tags. The plugin wraps it automatically.

.bra-calc-btn {
  border-radius: 30px;
}
.bra-calc-result {
  font-size: 52px;
}
Custom JavaScript

Enter plain JavaScript. Do not include <script> tags. Runs after calculator initializes.

document.addEventListener(
  'bra_calculator_result',
  function(e) {
    console.log(e.detail.size);
  }
);

Warning: Do not include <style> or <script> HTML tags - only raw CSS/JavaScript code. Click Save Code to apply, or Clear to remove all custom code.

Export / Import Tab

Bra Calculator → Export/Import

Back up all plugin settings and restore them on any site - including size charts, WooCommerce config, colors, and custom code.

Export Settings

Create a complete backup

Safe & Portable
  1. Click Export Settings button
  2. A .json file is generated and downloaded
  3. Store the backup file in a safe location

Import Settings

Restore from backup

Quick Recovery
  1. Drag & drop your .json or .txt backup file
  2. Or click Browse file to select it
  3. All settings are restored and the page refreshes

Importing overwrites all current settings. We recommend exporting a backup of your current settings before importing a new file.

License & Updates

Bra Calculator → License & Updates

An active license key is required to unlock all features and receive automatic updates.

License Status

Licensed

Updates and premium support are enabled for this site.

Licensed

Site

yoursite.com

Support Expires

Jun 30, 2026

Last Checked

Jun 23, 2026

Activating Your License

1

Find Your Purchase Code

Login to CodeCanyon → Downloads → WP Bra Calculator → License certificate & purchase code. Copy the Purchase Code.

2

Enter & Save the Key

In WordPress go to Bra Calculator → License & Updates. Paste your key and click Save License.

3

Confirm Licensed Status

Status changes to ● Licensed on success. All features unlock and automatic updates are enabled.

One License = One Site. A Regular License activates on one production domain. To transfer, click Deactivate on the old site first, then activate on the new domain.

WooCommerce Logic Rules

Logic Rules let you control exactly which WooCommerce products display the "Measure Bra Size" button.

Show to All

Button on every product page

Show If

Only on matching products

Hide If

Hidden on matching products

Logic Rule Examples

Scenario Configuration
Show button only on bra products Mode: Show if | Field: Category | Operator: Is in | Value: Bras
Hide button on accessories Mode: Hide if | Field: Category | Operator: Is in | Value: Accessories
Show on specific product Mode: Show if | Field: Product | Operator: Is in | Value: [product]
Show if tagged "lingerie" Mode: Show if | Field: Tag | Operator: Is in | Value: lingerie

Customization Tips

Override Plugin Styles via Theme

All calculator elements use the CSS class prefix .bra-calc-. You can add overrides in your theme or via Custom Code → Custom CSS:

/* Round the calculate button */
.bra-calc-btn-calculate {
  border-radius: 30px !important;
}

/* Make result size larger */
.bra-calc-result-size {
  font-size: 52px !important;
}

/* Control calculator width */
.bra-calc-wrap {
  max-width: 700px;
  margin: 0 auto;
}

JavaScript Events

The calculator fires a custom event when a result is calculated:

document.addEventListener('bra_calculator_result', function(e) {
  console.log('Size:', e.detail.size);
  console.log('Band:', e.detail.band);
  console.log('Bust:', e.detail.bust);
});

Recommended Image Sizes

Image Size Format
Band Size (Step 1) Illustration 600 × 600 px PNG (transparent) or JPEG
Bust Size (Step 2) Illustration 600 × 600 px PNG (transparent) or JPEG

Frequently Asked Questions

The calculator doesn't show after adding the shortcode - what's wrong?

Ensure: (1) License key is active, (2) At least one size chart is created in Size Builder and set to Active, (3) That chart is selected in Setup → Size Chart dropdown, and (4) Settings are saved. All three steps are required.

Can I use the calculator on multiple pages?

Yes. Place [bra_calculator] on as many pages or posts as you like. All instances share the same size chart and settings configured in the admin panel.

Do I need WooCommerce to use this plugin?

No. WooCommerce is entirely optional. The core calculator (shortcode, size chart, measurements, results) works on any WordPress site. WooCommerce features are optional additions for store owners.

WooCommerce products are not showing after calculation. Why?

Ensure: (1) WooCommerce integration is Enabled, (2) "Search related products" is Enabled, (3) Your products have size attributes matching the labels in your chart (e.g., "32B"). Check that products are Published and In Stock.

I changed my domain - do I need to reactivate the license?

Yes. Deactivate the license on the old domain via License & Updates tab, then activate it on the new domain using the same license key. Use Export/Import to move your settings between sites.

Is the plugin translation-ready (WPML / Polylang)?

Yes. WP Bra Calculator is fully internationalized using the WordPress i18n system with text domain wp-bra-calculator. Compatible with Loco Translate, WPML, and Polylang.

Does the plugin slow down my website?

No. Scripts and styles are loaded conditionally - only on pages where the shortcode is present. There is no global script loading on all pages. No external API calls are made on the front end.

Changelog

v2.0.0 June 2026 Latest
  • Complete UI redesign with tabbed admin navigation
  • Visual Size Chart Builder with Smart Validation
  • WooCommerce Matched Product Engine
  • Logic Block with product/category/tag rules (AND/OR)
  • Two calculator layout styles & two result box styles
  • Export / Import settings (JSON format)
  • Custom Code tab for CSS and JS injection
  • License & Updates system with automatic delivery
  • Full PHP 8.1+ strict typing and modern architecture
v1.0.0 Initial Release
  • Basic bra size calculator with band & bust inputs
  • Shortcode support: [bra_calculator]
  • Simple admin settings panel

Support

We're committed to providing excellent support for all licensed customers. Please check this documentation and the FAQ before reaching out.

In-Plugin Support Form

Bra Calculator → Get Support

Fill in your name, email, subject, and describe your issue directly from the plugin admin panel.

Within 24 hours (business days)

CodeCanyon Comments

CodeCanyon item page

Post a comment on the CodeCanyon item page. Responses are typically within 24-48 hours on business days.

Within 24-48 hours

What Our Support Covers

Plugin feature questions & configuration
Custom development requests
Bugs introduced by the plugin itself
Third-party plugin / theme conflicts
License activation issues
General WordPress or WooCommerce questions
WP Bra Calculator

Thank you for purchasing WP Bra Calculator. We hope it helps your customers find their perfect fit!

Made with care by KYNetCode