Authentication

Let customers log in to see private prices, saved configurations and their profile. Learn how to add the Mimeeq login code, login links and redirects.

This guide explains how to implement secure user authentication for your Mimeeq product configurators in the simplest way possible. By following these steps, you'll allow your customers to log in, access their private prices, saved (favourite) configurations, and manage their user profiles.

Key benefits:

• Secure access to your Mimeeq configurators

• Easy implementation with minimal technical knowledge

• Support for multiple languages

• Built-in password recovery functionality

---

Getting your authentication code

The first step is to obtain your unique Mimeeq authentication code from your admin panel.

1

Open the login code

1. Log in to your Mimeeq admin dashboard.

2. Navigate to Settings → Customer settings.

3. Click Code in the left sidebar.

4. Select Login Code.

2

Customise the settings (optional)

Before copying, you can:

• Select your preferred language from the dropdown.

• Choose theme options to match your website's design.

• Toggle Use default page font to let the login modal use your page font.

3

Copy the authentication code

1. You'll see an Embed Code snippet dialog.

2. Click Copy Script to copy the complete authentication code.

This code contains both your unique customer ID and the script that loads the authentication system.

---

Adding authentication to your website

1

Add the authentication code to your website

1. Paste the complete authentication code (that you copied using Copy Script) into your website's HTML.

2. Place it in your page's HTML for best performance.

3. This code only needs to be added once per page where authentication will be used.

<!-- Example of the complete authentication code -->
<mmq-auth short-code="{yourcode}" locale="en"></mmq-auth>
<script src="https://cdn.mimeeq.com/read_models/embed/app-embed.js" rel="script" type="application/javascript" async></script>

2

Set up authentication URL links

The simplest way to enable login functionality is by creating links that add ?auth=mimeeq to your website URL:

https://your-domain.com/?auth=mimeeq

When users click a link with this parameter, the login modal opens automatically without any additional HTML elements needed.

Create a login or My Account button or link on your website that adds this parameter to the URL. These links can be created from any button or element on your existing page:

<a href="?auth=mimeeq">Login</a>

Or for a specific page:

<a href="https://your-domain.com/page?auth=mimeeq">My Account</a>

Common use cases:

• Add a Login button in your navigation menu.

• Create My Account links in your website footer.

• Add login links on product pages.

Test the login process by clicking your authentication URL link and checking that the login modal appears and works correctly.

---

Managing user authentication

One of the major benefits of the URL authentication method is that the same link handles both login and logout automatically. The table shows what users see after clicking the ?auth=mimeeq link.

#	User state	What they see
1	Not logged in	The login modal
2	Already logged in	A prompt with options to log out or cancel

This means you only need to implement a single Account or Login link on your website. The Mimeeq authentication system handles the user's state and shows the appropriate modal. In other words, no additional code is required to handle these different states.

---

Language support

Mimeeq's authentication supports multiple languages:

1. The language is determined by the locale attribute in your authentication code (e.g. locale="en" for English).

2. To set or change the language, select your preferred language in the Embed Code snippet dialog in the admin panel before copying the code. The setting appears in the shortcode as locale="en", where en is your selected language code.

3. The language you select affects all text in the authentication modals.

---

Setting up the partner login redirect URL

When users sign up for the first time through the Mimeeq authentication system, you can automatically redirect them back to your website. This provides a seamless experience for your customers.

1. In your Mimeeq admin panel, go to Settings → Customer settings.

2. Look for the Partners Login Page field.

3. Enter the URL of your website where users should be redirected after authentication.

4. Include the ?auth=mimeeq parameter in this URL so the login modal opens automatically upon redirect.

When a user completes the authentication process, they are automatically redirected to this URL, which immediately opens the login modal thanks to the ?auth=mimeeq parameter.

---

Inviting users to your platform

You can invite users to register on your platform with Mimeeq authentication. For detailed instructions, see Invite Partners.

---

Customising the login appearance

Before copying your authentication code, you can customise its appearance in the admin panel's Embed Code snippet dialog:

• Button color override: set the primary button colour.

• Button text color override: set the text colour on buttons.

• Use default page font: match your website's typography.

These settings are applied to all authentication-related elements on your site.

---

Using authentication URLs effectively

The authentication URL approach (?auth=mimeeq) offers several advantages:

• Simplicity: no need for complex code or custom development.

• Consistency: the login experience is the same across your entire website.

• Flexibility: works with any website platform or content management system.

• User experience: a clean interface that doesn't disrupt your website design.

Best practices for authentication links

• Prominent placement: add login links in your main navigation for easy access.

• Clear labelling: use text like "Login", "My Account" or "Sign In" for your links.

• Consistent location: place authentication links in the same location across your site.

• Mobile friendly: make sure authentication links are accessible on mobile devices.

---

Common questions

Where can I find my authentication code?

In your Mimeeq admin panel under Settings → Customer settings → Code → Login Code.

Do I need to add the authentication code to every page?

Yes, for the best experience you should add it to every page where users might click a login link. The code is lightweight and loads asynchronously, so it won't affect your page performance.

What happens after a user logs in?

Users can access their saved configurations and personalised features of your Mimeeq configurator.

How do I know if authentication is working properly?

Test the login process by clicking your authentication URL link and checking that the login modal appears and works correctly.

---

For developers: programmatic authentication

If you have a developer on your team who needs more advanced implementation options, Mimeeq provides a comprehensive API for programmatic authentication:

• Custom login forms and interfaces

• Programmatic authentication flows

• User data access and management

• Custom authentication state handling

• Integration with existing user systems

For complete technical documentation on programmatic authentication methods, see https://docs.mimeeq.com/auth-introduction.

---

Related articles

Invite Partners

Invite client users to view prices and save favourites.

Restricted Access

Limit configurators to selected company groups.