# Popup

Popups are onsite messages you send to visitors based on their website behavior. These messages usually ask them to perform a specific action, such as:

* Viewing new products and services.
* Entering personal information, like their name, email address, and/or phone number.

The most common type of popup is the email popup (also known as a newsletter popup or email signup popup).&#x20;

### **When to use this popup?**

Use it to collect your visitors’ email addresses while offering free shipping, discounts, or anything else your customers will love.

### **Do email popups work?**

Research suggests that email popups convert an average of 6.57% of visitors on mobile, and 3.77% of visitors on desktop. And when you switch from a static signup form to a popup, the average increase in signups you may expect is around 100%.

### Gettings started

Go to `Online store` → `Themes` → `Customise`&#x20;

Then `Theme settings` → `Popup`

Here you will see the following configurations to customise your popup.

* Enable popup - this will show the popup to all visitors of your site
* Show on home page only - This will prevent the popup showing, for example, on the product or cart page
* Show only for visitors - will prevent the popup showing to customers who have an account and are logged in.

### Customise the content

You can change both the `Heading` and `Body text` that appears within the email popup to something more relevent with the option to hide the signup form itself, just in case you want to use the popup to display a generic message.

#### Additional settings

**Show newsletter** - show/hide the email form within the modal

**Delay until popup appears** - set the time before a user views the popup modal

**Color scheme** - pick the theme color profile to change the style of this feature.


---

# 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://erickson.gitbook.io/machina/theme-settings/typography-2.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.
