The Shopify plugin connects your configento.app configurator directly to your Shopify product pages. Customers configure, see the price update in real time, and check out through the native Shopify checkout — without leaving your store.
Requirements
- Shopify store running an Online Store 2.0 theme (e.g. Dawn, Sense, Refresh, Origin, or current premium themes). Legacy themes without JSON templates are not supported.
- Active configento.app account
- At least one configurator component in the configento.app backend (
admin.configento.app)
No Shopify Plus required — the plugin works on all Shopify plans.
Installation
- Search for "Configento Configurator" in the Shopify App Store.
- Click Add app.
- Confirm the permissions screen.
- Shopify automatically redirects you to the plugin's Embedded Admin.
Initial Setup
After installation, the Embedded Admin opens directly inside your Shopify backend.
Step 1 — Link your configento.app account
- Log in to the Service Portal (
service.configento.app). - Click "Create Shopify connection" → configento.app generates a 6-digit onboarding code (valid for 15 minutes).
- Enter the code in the Shopify Embedded Admin → Connect.
- Status changes to "Connected to: \<your account>".
Note: The connection is 1-to-1 (one Shopify store ↔ one configento.app account). To reconnect the store to a different account, uninstall and reinstall the app.
Step 2 — Link a product to a configurator component
In the Embedded Admin → "Products" tab:
- A list of all Shopify products with their current configurator assignment is shown.
- For each product: select a configento.app component from the dropdown.
- The selection is immediately saved as a metafield on the product.
Alternative: The metafield can also be set directly in the Shopify Admin: open a product → Metafields → Namespace configento, Key component_id, Type single_line_text_field, Value = component ID (numeric, e.g. 10244).
Step 3 — Place the Theme App Block
The configurator block needs to be activated once per theme:
- In the Embedded Admin, click "Add theme block".
- Shopify opens the Theme Editor and automatically adds the Configento block to the product page template.
- Important: Drag and drop the block between the product description and the price element.
- Save.
Block settings in the Theme Editor:
| Setting | Default | Description |
|---|---|---|
| Configento backend URL | https://admin.configento.app |
Only change if justSelling explicitly provides a different host |
| CSS selector for theme price | empty | Auto-detection works for most themes — only fill in for custom theme price selectors |
| Automatically place configurator above price | on | Moves the block above the theme price element on load, regardless of position in the Theme Editor |
| Show configuration summary | off | Displays a text summary below the configurator |
| Loading text | empty | Automatic language selection (DE/EN/ES/FR), can be overridden |
What happens at checkout?
- Customer opens the product page — the configurator loads automatically for all linked products.
- Customer makes their selection — the price in the theme updates in real time.
- Customer clicks "Add to cart" — the configuration is saved and the selected attributes appear in the cart as a bundle.
- Checkout and payment run through the native Shopify checkout — all payment methods, discount codes, and Shopify features remain fully available.
Multilingual support
The plugin supports German, English, Spanish, and French. The storefront configurator automatically follows the Shopify store language (Shopify Markets / Locale Selector). Other languages fall back to English.
Editing a saved configuration
The plugin automatically activates an "Edit" link on the cart page. Customers can use it to navigate back to the product page and adjust their configuration — as long as the checkout has not been completed. This behaviour can be disabled in the Theme Editor under "App embeds".
Troubleshooting
Configurator is not displayed:
| Symptom | Cause | Fix |
|---|---|---|
| Area completely empty | Theme App Block not activated | Embedded Admin → "Add theme block" |
| Loading text stays | Component ID missing or invalid | Embedded Admin → "Products" → assign component |
| Error message after 8 seconds | configento.app cloud not reachable | Check status.configento.app |
Wrong price in cart:
| Symptom | Cause | Fix |
|---|---|---|
| No surcharge in cart | Cart Transform Function not active | Reopen Embedded Admin (triggers reactivation) |
| Price difference between product page and cart | Currency/tax bridge misconfigured | Check Pricing tab in Embedded Admin |
Connection fails:
| Symptom | Cause | Fix |
|---|---|---|
| "Code invalid or expired" | Code older than 15 minutes | Generate a new code in the configento.app Service Portal |
| "Store already connected" | Connection exists for a different account | Uninstall and reinstall the app |