> For the complete documentation index, see [llms.txt](https://documentation.merge.email/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.merge.email/quickstart/installation.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_%F0%9F%93%A3/562406866377) if you haven’t already done so by clicking on the “Install” button.

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

* A pop-up will ask for your authorization to install the addon, 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 add-on has been installed.

<figure><img src="/files/JHos0QNfB4RAk3TCzFwo" alt="Mail Merge success message when installation is completed"><figcaption><p>Mail Merge success message when installation is completed</p></figcaption></figure>

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/fqC6sB46lzUVnt6DG9yr" alt=""><figcaption></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- Add-on doesn't seem to be installed successfully / I never get the "addon-installed successfully" popup:**

This issue can occur when you sign in 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, 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!