> For the complete documentation index, see [llms.txt](https://support.mailmergehow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.mailmergehow.com/quickstart/readme.md).

# Installation

On this page, you will find the 2 steps to install Mail Merge for Gmail Tools and how to access it.

There is a quick video if you don't have the time to read the documentation.

You will also find troubleshooting information about known issues that could happen.

### Install Mail Merge for Gmail <a href="#h.yh7yiptzhjsv_l" id="h.yh7yiptzhjsv_l"></a>

Install Mail Merge for Gmail from the [Google Workspace marketplace](https://workspace.google.com/marketplace/app/mail_merge_for_gmail_how/57033717989) if you haven’t already done so by clicking on the “Install” button.

<figure><img src="/files/eyURO9VpmWY80KRonqyN" alt="Mail Merge for Gmail How Simple on Google Workspace Marketplace"><figcaption><p>Mail Merge for Gmail How Simple on Google Workspace Marketplace</p></figcaption></figure>

* A pop-up will ask for your authorization to install the add-on, click on Continue
* Another popup will ask you for some permissions, click on "Allow"

After the installation (it usually takes less than 15 seconds) you will get a popup, saying that the add-on has been installed.

The next step is to open the add-on and let the magic happen.

### Launch Mail Merge for Gmail <a href="#h.4p9vsne6s5z4_l" id="h.4p9vsne6s5z4_l"></a>

<figure><img src="/files/HuyBgqg8lUKtL2qWblVQ" alt="Launch Mail Merge for Gmail Add-on from Google Sheets"><figcaption><p>Launch Mail Merge for Gmail Add-on from Google Sheets</p></figcaption></figure>

* Open Google Sheets (if Google Sheets was already opened, refresh the page)
* Add-ons take around 15s to load after you opened Google Sheets.
* Go to Extensions / Mail Merge For Gmail / Start ... there you go!

### Installation issues: <a href="#h.2zr90orf384h_l" id="h.2zr90orf384h_l"></a>

There are two known issues that we can't fix, as it doesn't depend on Mail Merge for Gmail:

**1- The add-on doesn't seem to be installed successfully / I never get the "add-on installed successfully" popup:**

This issue can occur when you sign in to Google accounts, and you are not using the principal account for installation. An easy workaround is to open a private window, sign in to the Google account you want, and then proceed to the installation.

**2- After successful installation, Merge for Gmail is not visible in Google Sheets:**

Simply refresh Google Sheets, wait for 10 seconds, and it should appear in the menu!
