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.
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
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.
Go to Plugins → Add New
In your WordPress admin, navigate to Plugins → Add New Plugin → Upload Plugin.
Upload the ZIP File
Click Choose File, select the downloaded ZIP, then click Install Now.
Activate the Plugin
Click Activate Plugin. A new Bra Calculator menu item will appear in the sidebar.
Activate Your License
Go to Bra Calculator → License & Updates and enter your purchase license key to unlock all features.
Extract the ZIP
Extract the downloaded ZIP on your computer. You'll get a folder named wp-bra-calculator.
Upload via FTP
Using FileZilla or any FTP client, upload the extracted folder to /wp-content/plugins/ on your server.
Activate in WordPress
Go to WordPress Admin → Plugins, find WP Bra Calculator, and click Activate.
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 minutesFollow these steps after installation to get the calculator live on your site in under 5 minutes.
Activate Your License Key
Navigate to Bra Calculator → License & Updates. Enter your purchase code and click Save License. Status shows Licensed on success.
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.
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.
Place the Shortcode
Create or edit any WordPress page and paste the shortcode below. Publish the page - your calculator is now live!
[bra_calculator]
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
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.
Select Countries
Choose which countries this chart applies to
Define Size Ranges
Set band & bust measurement ranges
Activate the Chart
Enable & select in Setup tab
Creating a Size Chart Step-by-Step
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.
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.
Add Size Rows (Underbust Ranges)
Click + Add Size Row. Set From-To underbust values and assign a size label (30, 32, 34...).
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.
Save & Activate
Click Save Chart. Then toggle the chart status to Active and select it in Setup → Size Chart.
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.
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. |
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.
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;
}
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
- Click Export Settings button
- A
.jsonfile is generated and downloaded - Store the backup file in a safe location
Import Settings
Restore from backup
- Drag & drop your
.jsonor.txtbackup file - Or click Browse file to select it
- 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.
Site
yoursite.com
Support Expires
Jun 30, 2026
Last Checked
Jun 23, 2026
Activating Your License
Find Your Purchase Code
Login to CodeCanyon → Downloads → WP Bra Calculator → License certificate & purchase code. Copy the Purchase Code.
Enter & Save the Key
In WordPress go to Bra Calculator → License & Updates. Paste your key and click Save License.
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
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.
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.
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.
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.
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.
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.
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
- 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
- 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 hoursWhat Our Support Covers
Thank you for purchasing WP Bra Calculator. We hope it helps your customers find their perfect fit!
Made with care by KYNetCode