> For the complete documentation index, see [llms.txt](https://help.mimeeq.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.mimeeq.com/commerce-and-integrations/woocommerce/admin-settings.md). # Admin Settings Complete reference for Mimeeq for WooCommerce admin settings — API keys, cart configuration, product naming templates, notifications, and more. ## Overview This article walks through every screen under **WP Admin → Mimeeq** and explains what each setting does, in plain terms. A paid Mimeeq account is required for any of this to work. The **Mimeeq** menu has several pages, each covering a different part of the setup: | Page | What it's for | | --------------------- | -------------------------------------------------- | | Dashboard | Overview and setup checklist | | API Settings | Connecting to your Mimeeq account | | Primary Settings | How configured products are created and named | | Button Settings | The look of the default "open configurator" button | | Notifications | Email alerts for technical problems | | Extension Settings | Advanced cart behavior and currency mapping | | Products Sync | Bulk-importing products from Mimeeq | | Error Recovery Center | Log of technical problems customers ran into | *** ## API Settings **Location:** WP Admin → Mimeeq → API Settings | Setting | What it does | | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Enable Integration | Turns the whole plugin's WooCommerce integration on or off | | API URL | Where the plugin talks to Mimeeq (leave as default unless told otherwise) | | API Key | Your personal key from your Mimeeq account — required | | Pricing API URL (optional) | Only needed if Mimeeq gave you a separate address for price lookups | | Load embed script from cdn.mimeeq.com | Advanced, optional. Off by default. Turning it on always fetches the very latest version of the 3D viewer from Mimeeq's servers instead of the copy bundled with the plugin | **Where to find your API Key:** 1. Log in to your Mimeeq account 2. Open your account/settings area 3. Copy the API Key shown there **How to enter it:** 1. Go to **WP Admin → Mimeeq → API Settings** 2. Paste the key into the **API Key** field 3. Click **Save Changes** ![Screenshot: API Key settings screen](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FYkpeoqfM5BuPMUM4dwQv%2F02-admin-settings-01-api-key-s_updu2c.png?alt=media) *** ## Primary Settings **Location:** WP Admin → Mimeeq → Primary Settings ### Cart Configuration This section controls what happens the moment a customer finishes configuring a product and adds it to their cart. | Setting | What it does | Choices | | ------------------------------------------ | ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Cart product creation method | How WooCommerce represents the configured item | **Create new product** (recommended) — a fresh, one-off product is created for that exact configuration. **Create product variant** — adds it as a variant of an existing product instead (requires Products Sync to be set up first) | | After add to cart action | What the customer sees right after adding to cart | **Redirect to cart** (recommended), **Close modal**, or **Do nothing** | | Zero price product handling | What happens if Mimeeq can't work out a price | **Block adding to cart** (recommended) — the customer can't proceed. **Allow adding to cart** — it's added anyway, at no charge | | Price list group (Mimeeq) | An optional Mimeeq price list ID to use for backend price lookups, if you use Mimeeq's price lists | Text field — leave blank if you're not using this | | Separate mapping per Mimeeq embed template | Only relevant with "Create product variant" — keeps a separate WooCommerce mapping for each embed template | On / Off | ![Screenshot: Cart Configuration settings](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FHFBz6cx5Ul1zz1DNvB9E%2F02-admin-settings-02-cart-conf_3zn220.png?alt=media) **A note on product visibility:** every product the plugin creates from a customer's configuration is automatically kept **private** — it won't show up in your shop's product listings, search results, or sitemap. Customers only ever reach it through their own cart or order. This isn't something you need to configure; it happens automatically so your product catalog doesn't fill up with one-off items. > If a price can't be determined, the failed attempt is recorded automatically — see [Error Recovery Center](/commerce-and-integrations/woocommerce/error-recovery.md). ### Dynamic Field Settings These settings control the name, description, and SKU given to newly created products, using simple placeholders that get swapped for real values. | Setting | What it does | | --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | What information to include with orders | Checkboxes: include the SKU, the variant code, and/or the short code with each order | | SKU Template | Pattern used to generate the product's SKU | | Cart product name template | Pattern used to generate the product's name | | Cart product description template | Pattern used to generate the product's description | | Product Tags | Tags automatically applied to every configured product. Defaults to `mimeeq-custom` — you don't have to set this yourself unless you want to change or add to it | | Product template | Default WooCommerce product template new products are based on | **Placeholders you can use in any of the templates above:** | Placeholder | What it becomes | | ----------------- | ------------------------------------------------------------------------- | | `{specification}` | A readable list of what the customer chose (recommended for descriptions) | | `{productName}` | The product's display name inside Mimeeq | | `{sku}` | The generated SKU for this exact configuration | | `{shortcode}` | A short unique code based on the configuration | | `{code}` | The variant code Mimeeq uses internally | Example: the default name template is `{productName} - Design Ref: {shortcode}`, which turns into something like *"Lounge Chair - Design Ref: FLYCPX"*. *** ## Connecting WooCommerce Products to Mimeeq Every product that should show a configurator needs to know which one to load. Two ways to do this: ### Method 1: Set It Up by Hand 1. Open a WooCommerce product for editing 2. Go to the **Mimeeq** tab in the Product Data section 3. Fill in: | Field | Required? | Purpose | | ------------------ | --------- | ------------------------------------------------------------------------------------ | | Product shortcode | Yes | Identifies which Mimeeq configurator to load | | Template ID | Yes | Identifies which embed template to use | | Configuration Code | No | Starts the configurator on a specific saved configuration instead of the default one | | Scene Shortcode | No | For modular/multi-part products — starts on a specific scene | | Public Price List | No | Overrides which Mimeeq price list this one product uses | ![Screenshot: Mimeeq tab in WooCommerce product editor](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FyaVQymkQ2zjafeIwZlY7%2F02-admin-settings-03-product-m_hwgmwj.png?alt=media) **Setting a specific starting configuration:** if you'd like the configurator to open with particular options already selected (instead of its defaults), get the corresponding code from your Mimeeq account and paste it into **Configuration Code** (or, for modular products, into **Scene Shortcode**). ### Method 2: Sync Many Products at Once **Location:** WP Admin → Mimeeq → Products Sync 1. Choose a sync mode: * **"Add only new and active products"** (recommended) — brings in anything new without touching what you've already set up * **"Override all (update existing)"** — replaces everything, including manual changes 2. Click **Synchronize Products** and wait for it to complete ![Screenshot: Products Sync screen](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2F8kZE6MpAn2o1bFTM4Ei1%2F02-admin-settings-04-product-s_ynofdq.png?alt=media) > ⚠️ "Override all" will overwrite any product details you've already changed by hand. Use it with care. Only products marked active/public in your Mimeeq account are brought in. If you're using the **"Create product variant"** method from Primary Settings, this sync is also what creates the underlying WooCommerce product that variants get attached to — the matching itself is entirely automatic; there's no extra step to map a specific product by hand. *** ## Button Settings **Location:** WP Admin → Mimeeq → Button Settings Sets the default look (color, shape, icon, animation) for the "open configurator" button used across your site. Any individual button block can override these defaults — see [Gutenberg Blocks & Elementor Widgets](/commerce-and-integrations/woocommerce/storefront-setup.md). *** ## Extension Settings **Location:** WP Admin → Mimeeq → Extension Settings | Setting | What it does | | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Enable advanced add-to-cart functionality for configured products | Turns on support for more complex configurations — custom bundles, multi-part (modular) products, and grouped items — as set up on the Mimeeq side. Leave off for simple, single-product configurators | | Enable back-to-configurator link for cart items | Lets customers click their item in the cart to go back and adjust the configuration before checking out | | Default Product Category | A WooCommerce category automatically applied to newly created products | | Currency / Price List Mapping | A table matching each currency/language to a Mimeeq price list — see [Multi-Currency & Multi-Market (WPML)](/commerce-and-integrations/woocommerce/multi-currency-wpml.md) | *** ## Notifications **Location:** WP Admin → Mimeeq → Notifications Set up which email addresses get alerted when customers run into technical problems. Full details in [Error Notification Emails](/commerce-and-integrations/woocommerce/error-notifications.md). *** ## Error Recovery Center **Location:** WP Admin → Mimeeq → Error Recovery Center A log of technical problems automatically recorded as they happen (configurator failing to load, price errors, and similar). See [Error Recovery Center](/commerce-and-integrations/woocommerce/error-recovery.md) for the full picture of what's tracked. *** ## Adding Mimeeq to Your Storefront Once your settings and products are ready, add the configurator to your pages. See [Gutenberg Blocks & Elementor Widgets](/commerce-and-integrations/woocommerce/storefront-setup.md). *** ## Related Articles * [Getting Started](/commerce-and-integrations/woocommerce/getting-started.md) * [Gutenberg Blocks & Elementor Widgets](/commerce-and-integrations/woocommerce/storefront-setup.md) * [Multi-Currency & Multi-Market (WPML)](/commerce-and-integrations/woocommerce/multi-currency-wpml.md) * [Custom Field Mappings](/commerce-and-integrations/woocommerce/custom-field-mappings.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.mimeeq.com/commerce-and-integrations/woocommerce/admin-settings.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.