---
title: "Google Email Configuration"
type: "wiki"
space: "Axero Documentation"
author: "Vladana Garic"
created: 2025-08-29T11:40:39Z
updated: 2026-09-28T00:03:51Z
url: "https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/109549/google-email-configuration"
---

# Google Email Configuration

**Important:** Google requires 2-Step Verification before you can use an App Password with Axero. An App Password is a 16-character password that gives Axero secure SMTP access \(the standard way to send email\) without exposing your main Gmail password.

* * *

## Step 1: Enable 2-Step Verification in your Google account

1. Go to https://myaccount.google.com/security.
2. Under **"How you sign in to Google"**, find **2-Step Verification**.
3. If it's not enabled, click it and follow the prompts to turn it on.
    - You'll need a phone number or an authentication app.

* * *

## Step 2: Generate an App Password

1. Go to https://myaccount.google.com/apppasswords.
2. Sign in again if prompted.
3. Type a name like Axero Email Integration, then click **Create**.
4. A **16-character App Password**will be shown, for example abcd efgh ijkl mnop.
    - **Copy this password**. It's only shown once.
    - You'll use it as the SMTP password in Axero.

* * *

## Step 3: Configure Axero SMTP settings for Gmail

1. Sign in to your Axero site as a site administrator.
2. Go to **Control Panel** > **System** > **General Settings** > **Email Settings**.
3. Under **SMTP server**, enter the following:

| Field | Value |
    | --- | --- |
    | From email address | Full Gmail address \(for example, you@gmail.com\) |
    | Friendly email name | Name to display in outgoing email |
    | SMTP server | `smtp.gmail.com` |
    | SMTP username | Full Gmail address \(for example, you@gmail.com\) |
    | SMTP password | Paste the App Password from Step 2 |
    | SMTP port | `587` |
    | Use SSL | Yes \(enabled\) |
4. Click **Save System Settings** at the bottom of the page.

* * *

## Step 4: Send a test email

1. Go to **Control Panel** > **People** > **Manage People**.
2. Click the **Options** menu and select **Mass Email**.
3. Under **1. Choose type of email**, select **Create custom email**.
4. Compose a test message.
5. Under **2. Choose people**, select test recipients.
6. Click **Send Email** at the bottom of the page.

* * *

## Notes

- Watch Gmail's sending limits. A personal Gmail account allows 500 messages a day and 500 recipients in a single message. Google Workspace allows 2,000 messages a day \(500 while the account is on trial\). It also allows 2,000 recipients per message, with no more than 500 of them outside your organization. A busy site can reach these limits, and sending pauses until the limit resets.
- If your site sends a lot of email, [contact Axero](https://my.axerosolutions.com/spaces/77/axero-online-support/cases/add-edit-case/0) about using the default email provider.
- This guide covers sending. The same App Password also lets Axero create cases from incoming Gmail. See [Manage Space: Case Projects](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/21581/manage-space-case-projects "Manage Space: Case Projects").

* * *

## App Passwords on Google Workspace

On a personal Gmail account, 2-Step Verification is all you need. On a Google Workspace \(work or school\) account, whether you can create an App Password depends on how your organization has set up the account:

- 2-Step Verification must be on for the user.
- Google does not offer App Passwords when 2-Step Verification is set up only for security keys, when the account has Advanced Protection, or when a work or school administrator has not made them available. Check with your Workspace administrator before relying on one.

**Axero has no other way to sign in to a Google mailbox.** Axero connects to Gmail only with an App Password. It does not offer Google OAuth \(signing in through Google's own consent screen\) for mail. If your Workspace administrator has disabled App Passwords, use a mailbox where App Passwords are permitted, or a different provider.

#### Related pages

- [Email Configuration Overview](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/22190/email-configuration-overview "Email Configuration Overview") \(for the Email Settings fields this password goes into\)
- [Microsoft 365 Email Configuration](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/109152/microsoft-365-email-configuration "Microsoft 365 Email Configuration") \(if the sending mailbox is on Microsoft 365 instead\)
- [Manage Space: Case Projects](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/21581/manage-space-case-projects "Manage Space: Case Projects") \(to use the same mailbox for incoming case email\)