WordPress Plugin in Elementor

Build a Simplio3D configurator page with Elementor. There are no separate Elementor widgets: every Simplio3D block is also a shortcode, and you place it with Elementor’s own Shortcode widget — one widget per block. The widgets share one live configuration, so the 3D view, options, price, summary and Add to Cart work exactly as the blocks do, and the 3D view is live in the Elementor editor too.

Before you start

  • The Simplio3D WordPress plugin, version 2.0.3 or newer, connected to your account — see WordPress Plugin. Earlier versions accept fewer shortcode settings.
  • The plugin in Simplio3D v3 mode. New installs start in it; a site updated from the earlier plugin switches in WordPress → Simplio3D → Migration.
  • A published project: Share dialog → share link on, no password. If you restrict domains, add your website’s domain.
  • Elementor. The free version is enough.
  • For Add to Cart: WooCommerce and a simple product with a price.

The five shortcodes

BlockShortcode
Viewer[simplio3d block="viewer" project="PROJECT-ID"]
Options (one option each)[simplio3d block="options" project="PROJECT-ID" option="OPTION-ID"]
Price[simplio3d block="price" project="PROJECT-ID"]
Summary[simplio3d block="summary" project="PROJECT-ID"]
Quote request[simplio3d block="action" project="PROJECT-ID"]
Add to Cart[simplio3d block="action" project="PROJECT-ID" mode="cart" product="123"]

Step 1: Copy the shortcodes from the block editor

Option ids aren’t shown in Simplio3D, so the quickest way to get every id — and every setting — is to set the page up once with blocks and copy the result.

  1. 1In WordPress, open Simplio3D → Account & Settings → “New page: Viewer + sidebar”. This creates a draft page with every block in place.
  2. 2Select the Viewer, click “Select project” and choose your project. The other blocks take the same project.
  3. 3Select each Simplio3D Options block and choose its option. Add more Options blocks until every option you want is there, and change any block settings you like — layout, labels, button text. Save the draft.
  4. 4Select a block, open its settings → Simplio3D advanced → “Copy shortcode”. The shortcode includes every setting you changed, so it shows exactly what the block shows.
Keep the draft unpublished as your list of shortcodes. Custom CSS and WordPress style controls (colour, typography, spacing, width) don’t come along — set those in Elementor instead (see Styling below).

Step 2: Build the layout in Elementor

  1. 1Open the page with “Edit with Elementor” and add a two-column container (about 60 % / 40 %).
  2. 2Search the Elements panel for “Shortcode”, drag it into the left column and paste the Viewer shortcode. The 3D view appears in the editor preview.
  3. 3In the right column, add one Shortcode widget per option, then one each for Price, Summary and Submit / Add to Cart.
  4. 4Publish and open the page. Change an option: the 3D view, price and summary update together.
Left column [simplio3d block="viewer" project="PROJECT-ID" height="620px" mobile_height="400px" loading="eager"] Right column (one Shortcode widget per line) [simplio3d block="options" project="PROJECT-ID" option="OPTION-ID-1"] [simplio3d block="options" project="PROJECT-ID" option="OPTION-ID-2" layout="dropdown"] [simplio3d block="price" project="PROJECT-ID"] [simplio3d block="summary" project="PROJECT-ID" summary_mode="compact"] [simplio3d block="action" project="PROJECT-ID" mode="cart" product="123" after_add="cart"]
All widgets with the same project are one configurator — use one Viewer per configurator. For two configurators on one page, give each set of widgets its own instance="…", for example instance="oak" and instance="walnut".

Step 3: Add to Cart (WooCommerce)

In the block editor, choosing a product in the Add to Cart block also links it to your project. A shortcode can’t do that, so link the product yourself:

  1. 1In WordPress, go to Products and edit a simple product with a regular price.
  2. 2In Product data → Simplio3D, choose your project and set Cart price to “Simplio3D calculated price (verified server-side)” — or keep the product’s WooCommerce price. Click Update.
  3. 3Note the product id: hover over the product in the Products list (“ID: 123”).
  4. 4Use it in the widget: [simplio3d block="action" project="PROJECT-ID" mode="cart" product="123"].
A product sold at the Simplio3D price can only enter the cart through the configurator — WooCommerce’s own Add to cart button refuses it. Put the configurator on its own page and link to it from the product. With Elementor Pro you can instead use these Shortcode widgets in a Single Product template (not Elementor’s Add to Cart widget); preview it before you go live.

Useful settings

Add these inside a shortcode. Type straight quotes "…": quotes copied from Word, Google Docs or Slack can turn curly, and WordPress then ignores the setting.

  • Set the viewer’s height on desktop and phones

    height="620px" mobile_height="400px"
  • Show a product without controls (hero section)

    toolbar="hide" ar="off" auto_rotate="on"
  • Show the full Simplio3D configurator in one widget (no option ids needed)

    display="hosted"
  • Show an option as a dropdown, list or text buttons (where its type allows it)

    layout="dropdown" (or list, buttons)
  • Fit more thumbnails in a row

    columns="4" thumbnails="small"
  • Show the price before tax, as in the WooCommerce cart

    tax_display="exclude"
  • Let the shopper choose the quantity, then go to the cart

    quantity_mode="selector" after_add="cart"
  • Rename the quote button

    button="Request a quote"

Styling

  • Each Shortcode widget’s Advanced tab in Elementor sets its margin, padding, background, border and responsive visibility.
  • The blocks use the page’s text colour and font. Set the accent colour (selected choice, buttons) in Appearance → Customize → Additional CSS, or in Elementor Pro’s Custom CSS. Classic themes such as Hello Elementor get a near-black accent until you do.
  • To style one widget only, add class="my-finish" to its shortcode and target .my-finish.
.simplio3d-block { --s3d-accent: var(--e-global-color-accent); --s3d-radius: 4px; }

If something doesn’t work

You seeWhat to do
The shortcode text itself on the pageThe plugin isn’t active, or the name is wrong: use [simplio3d …], not the earlier [simplio3d_configurator …].
Nothing at all, even when logged inThe site is still in Legacy mode (WordPress → Simplio3D → Migration → switch to v3), or block="…" is misspelt.
“Simplio3D: select a project for this block in the editor.”The project id is missing or wrong — curly quotes, a partial id, or PROJECT-ID left in. Only editors see this message.
“This configurator is not available right now.”Turn on the project’s share link (no password). For a brand-new project, click Simplio3D → Diagnostics → Test connection, then reload.
Options don’t change the 3D viewUse the same project (and the same instance, if any) in every widget.
“The product could not be added to the cart.”Link the product on its Simplio3D tab (Step 3); it must be a simple product with a price. Simplio3D → Diagnostics says which.
The price differs from the cart by the taxAdd tax_display="exclude" to the Price widget.
Text or an uploaded image isn’t shown on the modelUse display="hosted" on the Viewer to show the full configurator, which draws them.
These widgets are tested on normal pages and in Elementor’s editor preview. Elementor Pro templates, popups, tabs, accordions and loop grids aren’t — preview those before you go live.

More in Integrations

WooCommerceConnect WooCommerce and choose, per project, cart or checkout, the configured product with its 3D image and options, and the Simplio3D or WooCommerce price.WordPress PluginBuild configurator pages in WordPress from native blocks — Viewer, Options, Price, Summary and Add to Cart — connected to your account, with WooCommerce prices verified by Simplio3D.ShopifyUse the Simplio3D app for Shopify from the Shopify App Store (works for client-owned stores) or connect your own Shopify app in the dashboard, then sell configured products via cart permalinks, draft orders, or SKU-matched carts.Save and Add to CartAn Enterprise setting for Shopify: one click saves the shopper's design, emails them a link and adds that design to the cart. What shoppers see, what happens when a step fails, and what reaches Shopify.API & SDK Quick StartGet started with the Simplio3D REST API and headless TypeScript SDK to drive configurators from your own code.AI Connections (MCP)Connect ChatGPT or Claude in one click with the Simplio3D plugin, or any MCP agent with a scoped, expiring token — choose what it may change and approve every risky change in the app.Mobile & Native AppsEmbed your configurator in an iOS, Android, React Native, or Flutter app — web view setup, the AR hand-off, and the native event bridge.Building a Custom UIDesign your own configurator interface with @simplio3d/viewer — the platform renders the 3D product while you own every control, in any framework.Headless Integration WalkthroughShip a custom-UI configurator with @simplio3d/viewer step by step — install it, wire your own controls, handle failures, and avoid the traps that break silently.