Complete reference for all BoxBuilder settings across all 6 tabs.
BoxBuilder settings are found at BoxBuilder → Settings in your WordPress admin. Settings are organized into 6 tabs: General, Display, Labels, Gift Message, Cart, and Appearance.Click Save Settings at the bottom of any tab to apply changes. Settings apply globally to all box products unless overridden at the individual product level.
General
The General tab controls layout, positioning, interaction behavior, the box summary panel, progress indicators, and mobile settings.
Product Layout
Setting
Description
Options
Default
Layout Style
How products are displayed in the builder
Grid, List
Grid
Products Per Page
Number of products shown before pagination
Any number
12
Grid layout works best for visual browsing (e.g., chocolates, flowers). List layout is better when product details matter (e.g., items with descriptions or variations). Recommended: 8–16 products per page for optimal performance.
Builder Position
Setting
Description
Options
Default
Position on Product Page
Where the builder appears on the product page
After Product Details Block, Before Product Tabs, Replace Product Tabs, After Product Tabs, After Price, After Short Description, After Add to Cart Form, After Product Meta, Shortcode Only
Before Product Tabs
Summary Panel Position
Which side the box summary panel appears on
Right Side, Left Side
Right Side
Choosing the right position:
FSE/Block themes (e.g., Twenty Twenty-Four): Use “After Product Details Block”
Classic themes (e.g., Storefront, Astra): “Before Product Tabs” is recommended
Page builders (Elementor, Divi, etc.): Use “Shortcode Only” and place [boxbuilder] where you want
Interaction
Setting
Description
Options
Default
Add to Box Mode
How customers add products to the box
Button Click, Card Click (quick add), Both
Button Click
Quantity Controls
When +/- quantity buttons appear on product cards
Always Visible, On Hover, After First Add
Always Visible
“Card Click” mode is faster for high-volume stores where customers add many items quickly. “Both” gives customers the flexibility to use either method.
Box Summary
The summary panel shows selected items and the running total.
Setting
Description
Options
Default
Display Mode
How items appear in the summary panel
List View, Slot Grid, Minimal
List View
Show thumbnails in summary
Display product images next to items
Checkbox
Enabled
Show item prices in summary
Display individual prices for each item
Checkbox
Enabled
Slot Grid mode shows a visual representation of the box filling up — great for gift boxes where the “filling” experience matters. Minimal keeps the summary compact with just item names and counts.
Progress Indicators
Setting
Description
Options
Default
Show progress indicator
Display visual feedback for box completion
Checkbox
Enabled
Progress Style
Visual style for the progress indicator
Progress Bar, Percentage (50%), Slot Dots, Counter (6/12)
Progress Bar
Show “almost full” encouragement message
Display a motivational message when close to full
Checkbox
Enabled
Message Text
The encouragement message text
Text input
”Add more items!”
Use {count} in the message text as a placeholder for the number of remaining items. For example, “Add more items!” becomes “Add 3 more items!” when there are 3 slots left.
Mobile
Setting
Description
Options
Default
Mobile Layout
How the builder displays on mobile devices
Stacked (default), Tabbed (switch views)
Stacked
Summary Position
Where the summary appears relative to products (stacked layout only)
Below Products, Above Products
Below Products
Sticky Add to Cart button on mobile
Fix the Add to Cart button at the bottom of the screen
Checkbox
Enabled
Stacked layout shows products and summary vertically. Tabbed layout lets customers switch between “Products” and “Your Box” views — useful when screen space is limited.
Display
The Display tab controls product card information, stock management, and search/filter options.
Product Cards
Setting
Description
Default
Show price on each product card
Display the product price on the card
Enabled
Display “Only X left!” badge
Show a low stock warning badge
Enabled
Disable “Show price” for fixed-price boxes where individual item prices are irrelevant — customers only need to know the total box price.
Stock Management
Setting
Description
Options
Default
Out of Stock Products
How to handle products with zero stock
Show all (no indicator), Show with badge (disabled), Hide completely
Show with badge (disabled)
Low Stock Threshold
Stock level that triggers the “Only X left!” badge
Any number
5
“Show with badge (disabled)” keeps the product visible but prevents customers from adding it — this avoids confusion about missing products. “Hide completely” removes them entirely from the grid.
Search & Filter
Setting
Description
Options
Default
Enable product search
Show a search bar above the product grid
Checkbox
Enabled
Search Placeholder
Placeholder text shown in the search field
Text input
”Search products…”
Enable category filter
Show category filter controls
Checkbox
Enabled
Category Filter Style
How category filters are presented
Horizontal Tabs, Dropdown Select
Horizontal Tabs
Horizontal tabs work best when you have 2–5 categories. For 6+ categories, switch to the dropdown to avoid wrapping and clutter.
Labels
The Labels tab lets you customize all user-facing text strings in the builder interface.
Products Section
Setting
Description
Default
Section Title
Heading above the product grid
”Choose Your Products”
Section Subtitle
Subtitle text below the heading (leave empty to hide)
“Select items to add to your custom box.”
Add to Box Button
Text on the add button for each product
”Add to Box”
Box Summary Panel
Setting
Description
Default
Panel Title
Heading of the summary sidebar
”Your Box”
Slots Remaining Text
Text showing remaining capacity
” slots remaining”
Empty Box Title
Title shown when no items have been added
”Your box is empty”
Empty Box Hint
Helper text when box is empty
”Click on products to add them to your box.”
Add to Cart Button
Text on the final add-to-cart button
”Add Box to Cart”
Box Size Selector Title Pro
Heading above box size options
”Choose Your Box Size”
Use {count} in the “Slots Remaining Text” field as a placeholder for the number. For example, ” slots remaining” becomes “4 slots remaining” when there are 4 empty slots.
Gift Message
The Gift Message tab controls whether customers can add a personal note to their box.
Gift Message Toggle
Setting
Description
Default
Enable gift message field
Show the gift message textarea in the builder
Enabled
Require customers to enter a message
Make the gift message mandatory before adding to cart
Disabled
Field Settings
Setting
Description
Default
Field Label
Label shown above the text area
”Gift Message”
Placeholder Text
Placeholder inside the empty text area
”Add a personal message…”
Max Characters
Maximum character limit for the message (0 = unlimited)
500
Keep the character limit reasonable — 500 characters is typically enough for a thoughtful gift message without allowing excessively long text that could cause display issues on packing slips.
Cart
The Cart tab controls how boxes behave in the WooCommerce cart and after adding to cart.
Cart Display
Setting
Description
Default
Show list of items inside the box on cart page
Display individual box contents beneath the box item in cart
Enabled
Allow changing box quantity in cart
Let customers increase/decrease box quantity from the cart
Disabled
After Add to Cart
Setting
Description
Options
Default
Redirect To
Where to send customers after adding a box to cart
Cart Page, Checkout Page, Stay on Page
Cart Page
Box Sizes Pro
These settings control how multiple box sizes are presented when using Box Sizes in BoxBuilder Pro.
Setting
Description
Options
Default
Size Display Style
How size options are shown to customers
Cards (dropdown on mobile), Dropdown selector
Cards (dropdown on mobile)
Cards Per Row
Number of size cards per row (cards style only)
2, 3, 4, 5
3
Size Change Behavior
What happens when a customer switches to a smaller size and items exceed the new capacity
Keep items that fit, remove excess; Prevent size change; Show warning and ask to confirm
Keep items that fit, remove excess
Appearance
The Appearance tab controls colors, card styling, and advanced options.
Brand Colors
Setting
Description
Default
Primary Color
Main accent color used for buttons, selected states, and links
#5c6ac4
Success Color
Color used for “added” badges and confirmation states
#28a745
Choose a primary color that matches your store’s branding. The color picker supports hex values — click “Default” to reset to the original color.
Card Styling
Setting
Description
Options
Default
Corner Style
Border radius of product cards
Square (0px), Slightly Rounded (4px), Rounded (8px), More Rounded (12px), Very Rounded (16px)
Rounded (8px)
Card Shadow
Shadow effect on product cards
None (Flat), Light (Subtle), Medium (Prominent)
Light (Subtle)
Advanced Pro
Setting
Description
Default
Enable logging for troubleshooting
Write debug information to WooCommerce logs
Enabled
Leave logging enabled during setup and testing. You can disable it on production sites to avoid unnecessary log file growth. Logs are accessible at WooCommerce → Status → Logs.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/schema.json","name":"SwiftlyWP Docs","colors":{"primary":"#7B2D8B","light":"#9B4DAB","dark":"#5B1D6B"},"logo":{"light":"https://mintcdn.com/swiftlywp/24FBxSNjZv0BIRaf/logo/light.svg?fit=max\u0026auto=format\u0026n=24FBxSNjZv0BIRaf\u0026q=85\u0026s=339550530203eefaa435dc8b54689414","dark":"https://mintcdn.com/swiftlywp/24FBxSNjZv0BIRaf/logo/dark.svg?fit=max\u0026auto=format\u0026n=24FBxSNjZv0BIRaf\u0026q=85\u0026s=691c7a33661e3e7e1b2d721c37f45d06"},"favicon":"https://mintcdn.com/swiftlywp/wK8cL4JW-7WCgc65/favicon.png?fit=max\u0026auto=format\u0026n=wK8cL4JW-7WCgc65\u0026q=85\u0026s=aca7c74d718b80b57bd08f1a521776d6","styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"swiftlywp","hasAudioNarration":false,"actualSubdomain":"swiftlywp","customDomains":["docs.swiftlywp.com"],"gitSource":{"type":"github","owner":"chetanpal","repo":"docs","deployBranch":"main","isPrivate":false,"contentDirectory":"","mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae955aa8f05918ed283df80:success","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"BoxBuilder","count":31},{"language":"default","tag":"Pro Features","count":7},{"language":"default","tag":"Building Boxes","count":6},{"language":"default","tag":"Display \u0026 Customization","count":4},{"language":"default","tag":"Developer","count":4},{"language":"default","tag":"WooCommerce Integration","count":3},{"language":"default","tag":"Help","count":3},{"language":"default","tag":"Getting Started","count":3},{"language":"default","tag":"Settings Reference","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"plugins/boxbuilder/settings","slug":"/plugins/boxbuilder/settings","pageMetadata":{"title":"Settings Reference","description":"Complete reference for all BoxBuilder settings across all 6 tabs.","icon":"gear","href":"/plugins/boxbuilder/settings"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Complete reference for all BoxBuilder settings across all 6 tabs.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,hr:`hr`,li:`li`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Info,Table,Tip,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`BoxBuilder settings are found at `,_jsx(_components.strong,{children:`BoxBuilder → Settings`}),` in your WordPress admin. Settings are organized into 6 tabs: General, Display, Labels, Gift Message, Cart, and Appearance.`]}),`\n`,_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Save Settings`}),` at the bottom of any tab to apply changes. Settings apply globally to all box products unless overridden at the individual product level.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`general`,children:`General`}),`\n`,_jsx(_components.p,{children:`The General tab controls layout, positioning, interaction behavior, the box summary panel, progress indicators, and mobile settings.`}),`\n`,_jsx(Heading,{level:`3`,id:`product-layout`,children:`Product Layout`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Options`}),_jsx(_components.th,{children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Layout Style`}),_jsx(_components.td,{children:`How products are displayed in the builder`}),_jsx(_components.td,{children:`Grid, List`}),_jsx(_components.td,{children:`Grid`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Products Per Page`}),_jsx(_components.td,{children:`Number of products shown before pagination`}),_jsx(_components.td,{children:`Any number`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`12`})]})]})]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Grid layout works best for visual browsing (e.g., chocolates, flowers). List layout is better when product details matter (e.g., items with descriptions or variations). Recommended: 8–16 products per page for optimal performance.`})}),`\n`,_jsx(Heading,{level:`3`,id:`builder-position`,children:`Builder Position`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Options`}),_jsx(_components.th,{children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Position on Product Page`}),_jsx(_components.td,{children:`Where the builder appears on the product page`}),_jsx(_components.td,{children:`After Product Details Block, Before Product Tabs, Replace Product Tabs, After Product Tabs, After Price, After Short Description, After Add to Cart Form, After Product Meta, Shortcode Only`}),_jsx(_components.td,{children:`Before Product Tabs`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Summary Panel Position`}),_jsx(_components.td,{children:`Which side the box summary panel appears on`}),_jsx(_components.td,{children:`Right Side, Left Side`}),_jsx(_components.td,{children:`Right Side`})]})]})]}),`\n`,_jsxs(Info,{children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`Choosing the right position:`})}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`FSE/Block themes`}),` (e.g., Twenty Twenty-Four): Use “After Product Details Block”`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Classic themes`}),` (e.g., Storefront, Astra): “Before Product Tabs” is recommended`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Page builders`}),` (Elementor, Divi, etc.): Use “Shortcode Only” and place `,_jsx(_components.code,{children:`[boxbuilder]`}),` where you want`]}),`\n`]})]}),`\n`,_jsx(Heading,{level:`3`,id:`interaction`,children:`Interaction`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Options`}),_jsx(_components.th,{children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Add to Box Mode`}),_jsx(_components.td,{children:`How customers add products to the box`}),_jsx(_components.td,{children:`Button Click, Card Click (quick add), Both`}),_jsx(_components.td,{children:`Button Click`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Quantity Controls`}),_jsx(_components.td,{children:`When +/- quantity buttons appear on product cards`}),_jsx(_components.td,{children:`Always Visible, On Hover, After First Add`}),_jsx(_components.td,{children:`Always Visible`})]})]})]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`“Card Click” mode is faster for high-volume stores where customers add many items quickly. “Both” gives customers the flexibility to use either method.`})}),`\n`,_jsx(Heading,{level:`3`,id:`box-summary`,children:`Box Summary`}),`\n`,_jsx(_components.p,{children:`The summary panel shows selected items and the running total.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Options`}),_jsx(_components.th,{children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Display Mode`}),_jsx(_components.td,{children:`How items appear in the summary panel`}),_jsx(_components.td,{children:`List View, Slot Grid, Minimal`}),_jsx(_components.td,{children:`List View`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Show thumbnails in summary`}),_jsx(_components.td,{children:`Display product images next to items`}),_jsx(_components.td,{children:`Checkbox`}),_jsx(_components.td,{children:`Enabled`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Show item prices in summary`}),_jsx(_components.td,{children:`Display individual prices for each item`}),_jsx(_components.td,{children:`Checkbox`}),_jsx(_components.td,{children:`Enabled`})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Slot Grid`}),` mode shows a visual representation of the box filling up — great for gift boxes where the “filling” experience matters. `,_jsx(_components.strong,{children:`Minimal`}),` keeps the summary compact with just item names and counts.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`progress-indicators`,children:`Progress Indicators`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Options`}),_jsx(_components.th,{children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Show progress indicator`}),_jsx(_components.td,{children:`Display visual feedback for box completion`}),_jsx(_components.td,{children:`Checkbox`}),_jsx(_components.td,{children:`Enabled`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Progress Style`}),_jsx(_components.td,{children:`Visual style for the progress indicator`}),_jsx(_components.td,{children:`Progress Bar, Percentage (50%), Slot Dots, Counter (6/12)`}),_jsx(_components.td,{children:`Progress Bar`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Show “almost full” encouragement message`}),_jsx(_components.td,{children:`Display a motivational message when close to full`}),_jsx(_components.td,{children:`Checkbox`}),_jsx(_components.td,{children:`Enabled`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Message Text`}),_jsx(_components.td,{children:`The encouragement message text`}),_jsx(_components.td,{children:`Text input`}),_jsxs(_components.td,{children:[`”Add `,` more items!”`]})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`{count}`}),` in the message text as a placeholder for the number of remaining items. For example, “Add `,` more items!” becomes “Add 3 more items!” when there are 3 slots left.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`mobile`,children:`Mobile`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Options`}),_jsx(_components.th,{children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Mobile Layout`}),_jsx(_components.td,{children:`How the builder displays on mobile devices`}),_jsx(_components.td,{children:`Stacked (default), Tabbed (switch views)`}),_jsx(_components.td,{children:`Stacked`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Summary Position`}),_jsx(_components.td,{children:`Where the summary appears relative to products (stacked layout only)`}),_jsx(_components.td,{children:`Below Products, Above Products`}),_jsx(_components.td,{children:`Below Products`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Sticky Add to Cart button on mobile`}),_jsx(_components.td,{children:`Fix the Add to Cart button at the bottom of the screen`}),_jsx(_components.td,{children:`Checkbox`}),_jsx(_components.td,{children:`Enabled`})]})]})]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Stacked`}),` layout shows products and summary vertically. `,_jsx(_components.strong,{children:`Tabbed`}),` layout lets customers switch between “Products” and “Your Box” views — useful when screen space is limited.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`display`,children:`Display`}),`\n`,_jsx(_components.p,{children:`The Display tab controls product card information, stock management, and search/filter options.`}),`\n`,_jsx(Heading,{level:`3`,id:`product-cards`,children:`Product Cards`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Show price on each product card`}),_jsx(_components.td,{children:`Display the product price on the card`}),_jsx(_components.td,{children:`Enabled`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Display “Only X left!” badge`}),_jsx(_components.td,{children:`Show a low stock warning badge`}),_jsx(_components.td,{children:`Enabled`})]})]})]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Disable “Show price” for fixed-price boxes where individual item prices are irrelevant — customers only need to know the total box price.`})}),`\n`,_jsx(Heading,{level:`3`,id:`stock-management`,children:`Stock Management`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Options`}),_jsx(_components.th,{children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Out of Stock Products`}),_jsx(_components.td,{children:`How to handle products with zero stock`}),_jsx(_components.td,{children:`Show all (no indicator), Show with badge (disabled), Hide completely`}),_jsx(_components.td,{children:`Show with badge (disabled)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Low Stock Threshold`}),_jsx(_components.td,{children:`Stock level that triggers the “Only X left!” badge`}),_jsx(_components.td,{children:`Any number`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`5`})]})]})]}),`\n`,_jsx(Info,{children:_jsx(_components.p,{children:`“Show with badge (disabled)” keeps the product visible but prevents customers from adding it — this avoids confusion about missing products. “Hide completely” removes them entirely from the grid.`})}),`\n`,_jsx(Heading,{level:`3`,id:`search-\u0026-filter`,children:`Search \u0026 Filter`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Options`}),_jsx(_components.th,{children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Enable product search`}),_jsx(_components.td,{children:`Show a search bar above the product grid`}),_jsx(_components.td,{children:`Checkbox`}),_jsx(_components.td,{children:`Enabled`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Search Placeholder`}),_jsx(_components.td,{children:`Placeholder text shown in the search field`}),_jsx(_components.td,{children:`Text input`}),_jsx(_components.td,{children:`”Search products…”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Enable category filter`}),_jsx(_components.td,{children:`Show category filter controls`}),_jsx(_components.td,{children:`Checkbox`}),_jsx(_components.td,{children:`Enabled`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Category Filter Style`}),_jsx(_components.td,{children:`How category filters are presented`}),_jsx(_components.td,{children:`Horizontal Tabs, Dropdown Select`}),_jsx(_components.td,{children:`Horizontal Tabs`})]})]})]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Horizontal tabs work best when you have 2–5 categories. For 6+ categories, switch to the dropdown to avoid wrapping and clutter.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`labels`,children:`Labels`}),`\n`,_jsx(_components.p,{children:`The Labels tab lets you customize all user-facing text strings in the builder interface.`}),`\n`,_jsx(Heading,{level:`3`,id:`products-section`,children:`Products Section`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Section Title`}),_jsx(_components.td,{children:`Heading above the product grid`}),_jsx(_components.td,{children:`”Choose Your Products”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Section Subtitle`}),_jsx(_components.td,{children:`Subtitle text below the heading (leave empty to hide)`}),_jsx(_components.td,{children:`“Select items to add to your custom box.”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Add to Box Button`}),_jsx(_components.td,{children:`Text on the add button for each product`}),_jsx(_components.td,{children:`”Add to Box”`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`box-summary-panel`,children:`Box Summary Panel`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Panel Title`}),_jsx(_components.td,{children:`Heading of the summary sidebar`}),_jsx(_components.td,{children:`”Your Box”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Slots Remaining Text`}),_jsx(_components.td,{children:`Text showing remaining capacity`}),_jsxs(_components.td,{children:[`”`,` slots remaining”`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Empty Box Title`}),_jsx(_components.td,{children:`Title shown when no items have been added`}),_jsx(_components.td,{children:`”Your box is empty”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Empty Box Hint`}),_jsx(_components.td,{children:`Helper text when box is empty`}),_jsx(_components.td,{children:`”Click on products to add them to your box.”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Add to Cart Button`}),_jsx(_components.td,{children:`Text on the final add-to-cart button`}),_jsx(_components.td,{children:`”Add Box to Cart”`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Box Size Selector Title `,_jsx(`sup`,{children:`Pro`})]}),_jsx(_components.td,{children:`Heading above box size options`}),_jsx(_components.td,{children:`”Choose Your Box Size”`})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`{count}`}),` in the “Slots Remaining Text” field as a placeholder for the number. For example, ”`,` slots remaining” becomes “4 slots remaining” when there are 4 empty slots.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`gift-message`,children:`Gift Message`}),`\n`,_jsx(_components.p,{children:`The Gift Message tab controls whether customers can add a personal note to their box.`}),`\n`,_jsx(Heading,{level:`3`,id:`gift-message-toggle`,children:`Gift Message Toggle`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Enable gift message field`}),_jsx(_components.td,{children:`Show the gift message textarea in the builder`}),_jsx(_components.td,{children:`Enabled`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Require customers to enter a message`}),_jsx(_components.td,{children:`Make the gift message mandatory before adding to cart`}),_jsx(_components.td,{children:`Disabled`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`field-settings`,children:`Field Settings`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Field Label`}),_jsx(_components.td,{children:`Label shown above the text area`}),_jsx(_components.td,{children:`”Gift Message”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Placeholder Text`}),_jsx(_components.td,{children:`Placeholder inside the empty text area`}),_jsx(_components.td,{children:`”Add a personal message…”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Max Characters`}),_jsx(_components.td,{children:`Maximum character limit for the message (0 = unlimited)`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`500`})]})]})]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Keep the character limit reasonable — 500 characters is typically enough for a thoughtful gift message without allowing excessively long text that could cause display issues on packing slips.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`cart`,children:`Cart`}),`\n`,_jsx(_components.p,{children:`The Cart tab controls how boxes behave in the WooCommerce cart and after adding to cart.`}),`\n`,_jsx(Heading,{level:`3`,id:`cart-display`,children:`Cart Display`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Show list of items inside the box on cart page`}),_jsx(_components.td,{children:`Display individual box contents beneath the box item in cart`}),_jsx(_components.td,{children:`Enabled`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Allow changing box quantity in cart`}),_jsx(_components.td,{children:`Let customers increase/decrease box quantity from the cart`}),_jsx(_components.td,{children:`Disabled`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`after-add-to-cart`,children:`After Add to Cart`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Options`}),_jsx(_components.th,{children:`Default`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Redirect To`}),_jsx(_components.td,{children:`Where to send customers after adding a box to cart`}),_jsx(_components.td,{children:`Cart Page, Checkout Page, Stay on Page`}),_jsx(_components.td,{children:`Cart Page`})]})})]}),`\n`,_jsxs(Heading,{level:`3`,id:`box-sizes-pro`,children:[`Box Sizes `,_jsx(`sup`,{children:`Pro`})]}),`\n`,_jsxs(_components.p,{children:[`These settings control how multiple box sizes are presented when using `,_jsx(_components.a,{href:`/plugins/boxbuilder/box-sizes`,children:`Box Sizes`}),` in BoxBuilder Pro.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Options`}),_jsx(_components.th,{children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Size Display Style`}),_jsx(_components.td,{children:`How size options are shown to customers`}),_jsx(_components.td,{children:`Cards (dropdown on mobile), Dropdown selector`}),_jsx(_components.td,{children:`Cards (dropdown on mobile)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Cards Per Row`}),_jsx(_components.td,{children:`Number of size cards per row (cards style only)`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`2, 3, 4, 5`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`3`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Size Change Behavior`}),_jsx(_components.td,{children:`What happens when a customer switches to a smaller size and items exceed the new capacity`}),_jsx(_components.td,{children:`Keep items that fit, remove excess; Prevent size change; Show warning and ask to confirm`}),_jsx(_components.td,{children:`Keep items that fit, remove excess`})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`appearance`,children:`Appearance`}),`\n`,_jsx(_components.p,{children:`The Appearance tab controls colors, card styling, and advanced options.`}),`\n`,_jsx(Heading,{level:`3`,id:`brand-colors`,children:`Brand Colors`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Primary Color`}),_jsx(_components.td,{children:`Main accent color used for buttons, selected states, and links`}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`#5c6ac4`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Success Color`}),_jsx(_components.td,{children:`Color used for “added” badges and confirmation states`}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`#28a745`})})]})]})]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Choose a primary color that matches your store’s branding. The color picker supports hex values — click “Default” to reset to the original color.`})}),`\n`,_jsx(Heading,{level:`3`,id:`card-styling`,children:`Card Styling`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Options`}),_jsx(_components.th,{children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Corner Style`}),_jsx(_components.td,{children:`Border radius of product cards`}),_jsx(_components.td,{children:`Square (0px), Slightly Rounded (4px), Rounded (8px), More Rounded (12px), Very Rounded (16px)`}),_jsx(_components.td,{children:`Rounded (8px)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Card Shadow`}),_jsx(_components.td,{children:`Shadow effect on product cards`}),_jsx(_components.td,{children:`None (Flat), Light (Subtle), Medium (Prominent)`}),_jsx(_components.td,{children:`Light (Subtle)`})]})]})]}),`\n`,_jsxs(Heading,{level:`3`,id:`advanced-pro`,children:[`Advanced `,_jsx(`sup`,{children:`Pro`})]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Default`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Enable logging for troubleshooting`}),_jsx(_components.td,{children:`Write debug information to WooCommerce logs`}),_jsx(_components.td,{children:`Enabled`})]})})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Leave logging enabled during setup and testing. You can disable it on production sites to avoid unnecessary log file growth. Logs are accessible at `,_jsx(_components.strong,{children:`WooCommerce → Status → Logs`}),`.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Settings Reference","description":"Complete reference for all BoxBuilder settings across all 6 tabs.","icon":"gear","href":"/plugins/boxbuilder/settings"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"General","slug":"general","depth":2,"children":[{"title":"Product Layout","slug":"product-layout","depth":3,"children":[]},{"title":"Builder Position","slug":"builder-position","depth":3,"children":[]},{"title":"Interaction","slug":"interaction","depth":3,"children":[]},{"title":"Box Summary","slug":"box-summary","depth":3,"children":[]},{"title":"Progress Indicators","slug":"progress-indicators","depth":3,"children":[]},{"title":"Mobile","slug":"mobile","depth":3,"children":[]}]},{"title":"Display","slug":"display","depth":2,"children":[{"title":"Product Cards","slug":"product-cards","depth":3,"children":[]},{"title":"Stock Management","slug":"stock-management","depth":3,"children":[]},{"title":"Search \u0026 Filter","slug":"search-\u0026-filter","depth":3,"children":[]}]},{"title":"Labels","slug":"labels","depth":2,"children":[{"title":"Products Section","slug":"products-section","depth":3,"children":[]},{"title":"Box Summary Panel","slug":"box-summary-panel","depth":3,"children":[]}]},{"title":"Gift Message","slug":"gift-message","depth":2,"children":[{"title":"Gift Message Toggle","slug":"gift-message-toggle","depth":3,"children":[]},{"title":"Field Settings","slug":"field-settings","depth":3,"children":[]}]},{"title":"Cart","slug":"cart","depth":2,"children":[{"title":"Cart Display","slug":"cart-display","depth":3,"children":[]},{"title":"After Add to Cart","slug":"after-add-to-cart","depth":3,"children":[]},{"title":"Box Sizes Pro","slug":"box-sizes-pro","depth":3,"children":[]}]},{"title":"Appearance","slug":"appearance","depth":2,"children":[{"title":"Brand Colors","slug":"brand-colors","depth":3,"children":[]},{"title":"Card Styling","slug":"card-styling","depth":3,"children":[]},{"title":"Advanced Pro","slug":"advanced-pro","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":[],"subdomain":"swiftlywp","siteName":"SwiftlyWP Docs","title":"Settings Reference - SwiftlyWP Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-04-22T18:50:07.193Z","originalFileLocation":"plugins/boxbuilder/settings.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Complete reference for all BoxBuilder settings across all 6 tabs.\">\u003cmeta data-mint-head name=\"application-name\" content=\"SwiftlyWP Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/swiftlywp/LU6ygCSB7dieB2iA/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/swiftlywp/LU6ygCSB7dieB2iA/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/swiftlywp/LU6ygCSB7dieB2iA/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/swiftlywp/LU6ygCSB7dieB2iA/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/swiftlywp/LU6ygCSB7dieB2iA/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/swiftlywp/LU6ygCSB7dieB2iA/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/swiftlywp/LU6ygCSB7dieB2iA/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/swiftlywp/LU6ygCSB7dieB2iA/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/swiftlywp/LU6ygCSB7dieB2iA/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Settings Reference - SwiftlyWP Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Complete reference for all BoxBuilder settings across all 6 tabs.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"SwiftlyWP Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.swiftlywp.com/plugins/boxbuilder/settings\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://swiftlywp.mintlify.site/_mintlify/api/og/v2?division=Settings+Reference\u0026amp;title=Settings+Reference\u0026amp;description=Complete+reference+for+all+BoxBuilder+settings+across+all+6+tabs.\u0026amp;theme=b1c10560d2dd6e40075f7afe\u0026amp;signature=97a692ceaa21734c0b916f8517b0142cf81a7e615d126324ae6b0f0ce7e310b6\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Settings Reference - SwiftlyWP Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Complete reference for all BoxBuilder settings across all 6 tabs.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://swiftlywp.mintlify.site/_mintlify/api/og/v2?division=Settings+Reference\u0026amp;title=Settings+Reference\u0026amp;description=Complete+reference+for+all+BoxBuilder+settings+across+all+6+tabs.\u0026amp;theme=b1c10560d2dd6e40075f7afe\u0026amp;signature=97a692ceaa21734c0b916f8517b0142cf81a7e615d126324ae6b0f0ce7e310b6\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/swiftlywp/LU6ygCSB7dieB2iA/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"SwiftlyWP Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7B2D8B\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.swiftlywp.com/plugins/boxbuilder/settings\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/plugins/boxbuilder/settings.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.swiftlywp.com/#organization\",\"name\":\"SwiftlyWP Docs\",\"url\":\"https://docs.swiftlywp.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/swiftlywp/24FBxSNjZv0BIRaf/logo/light.svg?fit=max\u0026auto=format\u0026n=24FBxSNjZv0BIRaf\u0026q=85\u0026s=339550530203eefaa435dc8b54689414\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.swiftlywp.com#website\",\"name\":\"SwiftlyWP Docs\",\"url\":\"https://docs.swiftlywp.com\",\"publisher\":{\"@id\":\"https://docs.swiftlywp.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.swiftlywp.com/plugins/boxbuilder/settings#webpage\",\"url\":\"https://docs.swiftlywp.com/plugins/boxbuilder/settings\",\"name\":\"Settings Reference\",\"description\":\"Complete reference for all BoxBuilder settings across all 6 tabs.\",\"dateModified\":\"2026-04-22T18:50:07.193Z\",\"isPartOf\":{\"@id\":\"https://docs.swiftlywp.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.swiftlywp.com/plugins/boxbuilder/settings#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.swiftlywp.com/plugins/boxbuilder/settings#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"SwiftlyWP Docs\",\"item\":\"https://docs.swiftlywp.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Settings Reference\",\"item\":\"https://docs.swiftlywp.com/plugins/boxbuilder/settings\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.swiftlywp.com/plugins/boxbuilder/settings#article\",\"headline\":\"Settings Reference\",\"name\":\"Settings Reference\",\"description\":\"Complete reference for all BoxBuilder settings across all 6 tabs.\",\"url\":\"https://docs.swiftlywp.com/plugins/boxbuilder/settings\",\"mainEntityOfPage\":{\"@id\":\"https://docs.swiftlywp.com/plugins/boxbuilder/settings#webpage\"},\"dateModified\":\"2026-04-22T18:50:07.193Z\",\"publisher\":{\"@id\":\"https://docs.swiftlywp.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.swiftlywp.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"SwiftlyWP Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"SwiftlyWP Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/plugins/boxbuilder/settings.md","siteName":"SwiftlyWP Docs","nav":{"global":null,"tabs":[{"tab":"BoxBuilder","icon":"box","groups":[{"group":"Getting Started","pages":[{"title":"Introduction","icon":"box","href":"/plugins/boxbuilder/introduction"},{"title":"Installation","icon":"download","href":"/plugins/boxbuilder/installation"},{"title":"Quickstart","icon":"rocket","href":"/plugins/boxbuilder/quickstart"}]},{"group":"Building Boxes","pages":[{"title":"Creating a Box Product","icon":"box-open","href":"/plugins/boxbuilder/creating-a-box"},{"title":"Product Selection","icon":"grid-2","href":"/plugins/boxbuilder/product-selection"},{"title":"Pricing Models","icon":"dollar-sign","href":"/plugins/boxbuilder/pricing-models"},{"title":"Gift Messages","icon":"message","href":"/plugins/boxbuilder/gift-messages"},{"title":"Custom Items","sidebarTitle":"Custom Items","icon":"pen-to-square","href":"/plugins/boxbuilder/custom-items"},{"title":"Box Sizes","sidebarTitle":"Box Sizes","icon":"expand","href":"/plugins/boxbuilder/box-sizes"}]},{"group":"Display \u0026 Customization","pages":[{"title":"Layouts \u0026 Display","icon":"table-layout","href":"/plugins/boxbuilder/layouts"},{"title":"Shortcode \u0026 Block","icon":"code","href":"/plugins/boxbuilder/shortcode-and-block"},{"title":"Builder Position","icon":"arrows-up-down-left-right","href":"/plugins/boxbuilder/builder-position"},{"title":"Appearance","icon":"palette","href":"/plugins/boxbuilder/appearance"}]},{"group":"WooCommerce Integration","pages":[{"title":"Cart Integration","icon":"cart-shopping","href":"/plugins/boxbuilder/cart-integration"},{"title":"Orders \u0026 Emails","icon":"envelope","href":"/plugins/boxbuilder/orders-and-emails"},{"title":"Inventory Management","description":"How BoxBuilder handles stock for individual products in boxes.","icon":"warehouse","href":"/plugins/boxbuilder/inventory"}]},{"group":"Settings Reference","pages":[{"title":"Settings Reference","icon":"gear","href":"/plugins/boxbuilder/settings"}]},{"group":"Pro Features","pages":[{"title":"Pro Features Overview","sidebarTitle":"Overview","description":"Everything included in BoxBuilder Pro.","icon":"bolt","href":"/plugins/boxbuilder/pro-overview"},{"title":"Category Filters","icon":"filter","href":"/plugins/boxbuilder/category-filters"},{"title":"Analytics Dashboard","icon":"chart-line","href":"/plugins/boxbuilder/analytics"},{"title":"Saved Boxes","icon":"bookmark","href":"/plugins/boxbuilder/saved-boxes"},{"title":"Shareable Box URLs","icon":"share","href":"/plugins/boxbuilder/shareable-boxes"},{"title":"Subscription Boxes","icon":"rotate","href":"/plugins/boxbuilder/subscriptions"},{"title":"Multi-Currency \u0026 WPML","icon":"globe","href":"/plugins/boxbuilder/multi-currency"}]},{"group":"Developer","pages":[{"title":"Hooks \u0026 Filters","icon":"code","href":"/plugins/boxbuilder/hooks-and-filters"},{"title":"Template Overrides","icon":"file-code","href":"/plugins/boxbuilder/template-overrides"},{"title":"REST API","icon":"plug","href":"/plugins/boxbuilder/rest-api"},{"title":"Data Storage","icon":"database","href":"/plugins/boxbuilder/data-storage"}]},{"group":"Help","pages":[{"title":"Troubleshooting","icon":"wrench","href":"/plugins/boxbuilder/troubleshooting"},{"title":"Compatibility","icon":"puzzle-piece","href":"/plugins/boxbuilder/compatibility"},{"title":"FAQ","icon":"circle-question","href":"/plugins/boxbuilder/faq"}]}]}]},"basePath":"","title":"Settings Reference - SwiftlyWP Docs","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}