> For the complete documentation index, see [llms.txt](https://learn.cozmos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.cozmos.com/guides/ecommerce/shopify-integration/shopify-multipass.md).

# Shopify Multipass

{% hint style="info" %}
Please be aware. The Multipass function is only available to Shopify Plus plans
{% endhint %}

Creating a connected experience for logged in customers can lead to greater conversion by not forcing a customer to log in multiple times. With Multipass you can forward user data from your resources through the Sphere platform.

Example:

* Customer goes to <mark style="color:yellow;">[www.myshop.com](http://www.myshop.com)</mark> and creates an account/logs in to an existing account
* From <mark style="color:yellow;">[www.myshop.com](http://www.myshop.com)</mark> the logged in user clicks a link to visit your ecommerce sphere at <mark style="color:yellow;">[www.sphere.myshop.com](http://www.sphere.myshop.com)</mark> and is still authenticated as part of the redirection process with multipass.&#x20;

### How to enable Multipass in Shopify

Go to your Shopify store admin panel and enable the Multipass function under the 'Customer accounts' options.

<figure><img src="/files/mcbawFyXfLE6k2ohT4xK" alt=""><figcaption></figcaption></figure>

### Technical Setup in Shopify

You may use the same functionality you are currently using to generate Shopify tokens, change the <mark style="color:yellow;">`return_to`</mark>key and use a direct link to a sphere as specified below:

* When you generate a secured token based on the Shopify hash as provided in the Shopify Multipass documentation [Multipass](https://shopify.dev/api/multipass), place it inside the key <mark style="color:yellow;">`return_to`</mark> with a link to the sphere:
  * the link should be the direct link to the sphere you want to be opened, e.g.: a link could be as follows: <mark style="color:yellow;">`https://[subdomain].[domain]/en/[spherename]`</mark>
* When the user clicks the link to open a sphere, you should redirect them to the fixed route and add the Multipass token as a parameter <mark style="color:yellow;">`sphere_multipass_token`</mark> so that the final link would look like the following example: <mark style="color:yellow;">`https://[subdomain].[domain]/en/[spherename]?multipass_token=insert_token`</mark>

Next, login to your Cozmos space and go to Settings / Ecommerce providers / Shopify

<figure><img src="/files/VlwIRTsYnR2AnI2PPnFU" alt=""><figcaption></figcaption></figure>

If your store is already connected below the connection data you will see a toggle for Multipass. Enable this toggle and input your Shopify secret key

<figure><img src="/files/vsU1CSZmjIPSZA6t88sY" alt="Multipass"><figcaption></figcaption></figure>

Your Multipass login secret is available in your Shopify admin panel once you have configured Multipass.

The other input field shown above <mark style="color:yellow;">`Client's sign in URL`</mark> relates to the reverse flow, where a user first lands on the Sphere and not your main storefront.

Input your login url in this field, if a user clicks on the account button within Sphere they will be redirected to this url and once authenticated, will be returned to the Sphere.

To find out more about Multipass, view the [Shopify developer documentation](https://shopify.dev/docs/api/multipass).


---

# 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://learn.cozmos.com/guides/ecommerce/shopify-integration/shopify-multipass.md?ask=<question>&goal=<endgoal>
```

`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.