# Loqate

Limio Checkout aims to make the experience of purchasing your product an efficient and seamless experience. Loqate Autocomplete helps pre-populating the checkout's address forms with address information, expedite the checkout flows, and prevent user error as below.

Loqate works with Limio's legacy Single Page Checkout and Limio's newer Modular Checkout.

<figure><img src="/files/2ZregBXdulKIhZURXrPx" alt=""><figcaption></figcaption></figure>

## Setup in Loqate

Limio integrates to Loqate via an API Key, if you do not already have a production API Key, follow the instructions below to generate one.

1. Login to your [Loqate](https://www.loqate.com/) account
2. Press the “Add Service +” button at the top of the page
3. Choose the “API Key” option from the list of services
4. This will show you your new API Key. Make a note of this as it will be used in Limio setup later.
5. Optionally, you may wish to set a Daily Lookup Limit to cap spending which can be done on the Limits tab
6. Save your new API Key and continue to setup of Loqate in Limio

## Setup in Limio

### On Pages:

Once set up in Loqate is complete you can add the Loqate script to the specific page you need it on, for example the checkout page:

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

You may also need to add it on the page with the following components:

* Orders Table (includes change delivery address for physical products)
* Payments Table (includes change billing address for all products)
* Switch Subscription (includes change delivery address for physical products)

### In Settings:

#### Activation

You then need to configure the Loqate integration in Limio Settings. You can access the settings in Limio for Loqate, go to **Profile -> Settings -> Shop.**

<figure><img src="/files/4AYAjaLNnwsctAebDp0m" alt=""><figcaption></figcaption></figure>

To enable Loqate on the Limio Checkout:

1. Enable the setting "Use Loqate in checkout?"
2. Provide the API Key, which was generated in the Loqate step, in the setting titled "Loqate API Key"

#### Country whitelist

Optionally, you can choose which countries Loqate is enabled for using the "Loqate country allow list" setting. Once this setting is filled out, Limio Checkout will only autocomplete in the countries specified. This provides flexibility for countries with addresses using an alphabet not currently supported by your business. Note that transliteration is [currently in beta in Loqate](https://www.loqate.com/resources/blog/what-is-transliteration-and-why-is-it-important-for-address-verification/).

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

| Note                                                                                                                                           |
| ---------------------------------------------------------------------------------------------------------------------------------------------- |
| By default Limio Checkout will limit the countries available in the Auto Complete to the countries specified in the Loqate country allow list. |
|                                                                                                                                                |

#### Allowed Hosts

After enabling the Loqate functionality, you'll also have to add exceptions (https\://\*.[pcapredict.com](http://pcapredict.com/), https\://\*.[postcodeanywhere.co.uk](http://postcodeanywhere.co.uk/)) in the allowed hosts list in order for autocompletion to work.

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


---

# Agent Instructions: 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:

```
GET https://docs.limio.com/integrations/other-integrations/loqate.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.