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
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
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
“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.
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
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
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
Disable “Show price” for fixed-price boxes where individual item prices are irrelevant — customers only need to know the total box price.
Stock Management
“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
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
Box Summary Panel
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
Field Settings
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
After Add to Cart
Box Sizes Pro
These settings control how multiple box sizes are presented when using Box Sizes in BoxBuilder Pro.
Appearance
The Appearance tab controls colors, card styling, and advanced options.
Brand Colors
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
Advanced Pro
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.
