> 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/mimeeq-basket/basket-website-embed.md).

# Basket Website Embed

Add the Mimeeq Basket to your website with an embed template or standalone code. Learn each setting and how to translate the Basket interface.

Add the Mimeeq Basket to your website so customers can collect products and submit orders or quote requests.

***

## Choose an embed method

You can embed the Mimeeq Basket in two ways. Choose the method that best suits your integration.

<table><thead><tr><th width="45.44921875">#</th><th>Method</th><th>Best for</th></tr></thead><tbody><tr><td>1</td><td><strong>Embed template</strong></td><td>Showing the Basket as part of an existing configurator or product list embed.</td></tr><tr><td>2</td><td><strong>Direct basket embed code</strong></td><td>Standalone Basket embedding on pages without a configurator or product list.</td></tr></tbody></table>

***

## Embed the basket

{% tabs %}
{% tab title="Embed template" %}
This method integrates the Basket into your existing configurator or product list embed, so it appears directly on product or configurator pages.

1. Go to **Settings** → **Data** → **Embed Templates**, then select the template currently embedded or create a new one.
2. Activate Basket mode using the settings below.

<table><thead><tr><th width="46.99609375">#</th><th width="199.94921875">Name</th><th>Description</th></tr></thead><tbody><tr><td>1</td><td><strong>Basket Support</strong></td><td>Enables Basket mode.</td></tr><tr><td>2</td><td><strong>Show Basket only for Logged in Users</strong></td><td>Restricts Basket visibility to users who are logged in.</td></tr><tr><td>3</td><td><strong>Use Custom Pricing</strong></td><td>Allows pricing integration from other systems (for example custom APIs, Shopify or ERP), overriding the default pricing from Mimeeq.</td></tr><tr><td>4</td><td><strong>Add to Cart Placement</strong></td><td>Sets where the <strong>Add to Cart</strong> button is displayed: on the Summary Screen or replacing the <strong>Finish</strong> button.</td></tr><tr><td>5</td><td><strong>Add to Cart Placement (Modular)</strong></td><td>Sets the button placement for the Modular Configurator: on the Finish or Summary Screen.</td></tr><tr><td>6</td><td><strong>Integration</strong></td><td>Select <strong>Mimeeq</strong> (uses the Mimeeq Basket) or <strong>HTML Integration</strong> (allows integration with other systems, for example Shopify).</td></tr><tr><td>7</td><td><strong>Explore Products URL</strong></td><td>Where users are redirected to explore products. Usually shown when the Basket is empty or after submission.</td></tr><tr><td>8</td><td><strong>View Basket Online URL</strong></td><td>Overrides the default View Basket Online URL used in emails and previews.</td></tr></tbody></table>

![Embed template settings with the Basket options](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FMWEQG8yOTKr4gcOGaibC%2Fbasket-image-17-new_1ugnxao.png?alt=media)

3. Copy the generated script and paste it into your website's HTML to display the Basket with the configurator or product list.

![Generating and copying the embed template script](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FskzvVKHLuutzNFNWHd11%2Fbasket-image-18_vepvwe.png?alt=media)
{% endtab %}

{% tab title="Direct basket embed code" %}
This method embeds the Basket on its own, which is useful for pages without a configurator or product list.

1. Click the **Basket Code** button on the Basket settings page.

![Basket Code button on the Basket settings page](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2F8kKGykxwJm9PYaCuqUoL%2Fbasket-image-19_133m2he.png?alt=media)

2. Configure the settings below.

| # | Name                                     | Description                                                                                                 |
| - | ---------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| 1 | **Language**                             | Sets the language of the Basket interface labels, buttons and messages.                                     |
| 2 | **Public Price List Group**              | Sets the price list group applied to the Basket, which determines the prices shown to users.                |
| 3 | **Explore Products URL**                 | Where users are redirected to explore products. Usually shown when the Basket is empty or after submission. |
| 4 | **View Basket Online URL**               | Overrides the default URL for viewing the Basket online, directing users to a custom web page.              |
| 5 | **Use Default Language Font**            | Toggles whether to use the default font of the web page for the Basket interface.                           |
| 6 | **Show Basket only for Logged in Users** | Restricts Basket visibility to logged-in users, hiding it from public or anonymous users.                   |
| 7 | **Button Colour Override**               | Overrides the background colour of the buttons.                                                             |
| 8 | **Button Colour Text Override**          | Overrides the text colour of the buttons.                                                                   |

![Basket code snippet settings](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FhxkSTYHP2V7I41DXQUAu%2Fbasket-image-20_14opwtk.png?alt=media)

3. Copy the code snippet and paste it into your website's HTML. The Basket then displays independently, for example on your homepage or contact page, with a floating **Add to Cart** button visible across all pages.
   {% endtab %}
   {% endtabs %}

***

## Translate the basket interface

Every element of the Basket embed is fully translatable, as with all Mimeeq embeds. For the complete list of available translations, see our [developer documentation](https://docs.mimeeq.com/custom-translations/#available-chunks).

The snippet below shows the translatable items available at the time of writing. Check the developer docs regularly for the latest updates. Add the snippet alongside your configurator embed or directly in your page footer.

```json
{
  "basket.contact.confirmEmail": "Confirm Email",
  "basket.contact.submit": "Send Order",
  "basket.item.note": "Note (optional)",
  "basket.item.removeTooltip": "Remove this item",
  "basket.item.specification": "Specification",
  "basket.item.subtotal": "Items Value",
  "basket.item.unitPrice": "Unit price",
  "basket.item.modularConfiguration": "Configuration ref:",
  "basket.panel.contact.header": "Add Contact Details",
  "basket.panel.empty.description":
    "Add at least one item to a basket for making an order or generation a quotation",
  "basket.panel.empty.explore": "Explore Products",
  "basket.panel.empty.header": "Your basket is empty",
  "basket.panel.header": "Basket {count, plural, =0 { } other {(#)}}",
  "basket.panel.requestQuote": "Place Order",
  "basket.panel.total": "Total",
  "basket.panel.additionsCalculatedAtNextStep":
    "Additions and discounts are calculated at the next step.",
  "basket.success.email": "A copy has been sent to the email you submitted for your reference.",
  "basket.success.spam": "Please check your spam folder if you do not see our email in your inbox.",
  "basket.success.explore": "Browse More Products",
  "basket.success.header": "{submissionDisplayName} Sent",
  "basket.success.reference": "Your Submission Reference is {referenceCode}.",
  "basket.success.subheader": "Thank you for submitting your {submissionName}!",
  "basket.preview.item.note": "Note:",
  "basket.preview.item.quantity": "Qty:",
  "basket.preview.item.shortCode": "Configuration ref:",
  "basket.preview.item.sku": "SKU:",
  "basket.preview.item.unitPrice": "Unit price:",
  "basket.preview.item.totalPrice": "Total price:",
  "basket.preview.tax": "Tax ({tax, number, percent})",
  "basket.preview.total": "Total",
  "basket.submit.error": "Error occurred",
  "basket.submit.error.description":
    "During submitting your cart some unknown error occurred. Please try again",
  "basket.warn.outdated": "Cart outdated",
  "basket.warn.outdated.desc": "Some of the items at cart were updated. Please validate it.",
}
```

{% hint style="info" %}
To translate the emails and PDFs sent after submission, see [Customise basket emails and PDFs](/commerce-and-integrations/mimeeq-basket/basket-emails-and-pdfs.md).
{% endhint %}

***

## Test your setup

Run a test before you go live to make sure everything works as expected. [**Explore our live demo**](https://codepen.io/mimeeq/live/XWEYQoQ/04205ba63bd5c9337414fad93c39faae) and submit a Basket to experience the entire process.

If you would like help embedding the Mimeeq Basket on your website, reach out to us or contact support for assistance.

***

## Related articles

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Configure basket settings</strong></td><td>Set primary details, choose form fields and add recipient emails.</td><td><a href="/commerce-and-integrations/mimeeq-basket/basket-settings.md">Basket Settings</a></td></tr><tr><td><strong>Customise basket emails and PDFs</strong></td><td>Personalise and translate the emails and PDFs sent for every submission.</td><td><a href="/commerce-and-integrations/mimeeq-basket/basket-emails-and-pdfs.md">Basket Emails &amp; PDFs</a></td></tr><tr><td><strong>Manage submitted baskets and quotes</strong></td><td>Review submissions and add baskets to new or existing quotes.</td><td><a href="/commerce-and-integrations/mimeeq-basket/basket-submissions-and-quotes.md">Basket Submissions &amp; Quotes</a></td></tr></tbody></table>


---

# 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 following URL with the `ask` and `goal` query parameters:

```
GET https://help.mimeeq.com/commerce-and-integrations/mimeeq-basket/basket-website-embed.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case.

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.