> ## Documentation Index
> Fetch the complete documentation index at: https://ext.eplus.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Usage

> Set up accounts, generate aliases, and manage saved Gmail variations

## Set up your first account

<Steps>
  <Step title="Open Gmail Alias Toolkit">
    Select the extension icon from the browser toolbar. Pin it from the extensions menu if you use it frequently.
  </Step>

  <Step title="Enter your Gmail address">
    Add the base address that should receive the aliases. You can also add an optional label such as **Personal**, **Work**, or **Testing**.
  </Step>

  <Step title="Complete setup">
    Select **Get Started**. The account becomes the active Gmail address used by the alias generators.
  </Step>
</Steps>

<Tip>
  You can add more accounts later from **Settings → Accounts**. History, favorites, and statistics are kept separate for each account.
</Tip>

## Generate random aliases

Open the **Random** tab, choose how many aliases to create, and select a format:

| Format            | Example tag         |
| ----------------- | ------------------- |
| Private Mail      | `private-mail-k8m2` |
| Random Characters | `a7c2x9pq`          |
| Random Words      | `happy-fox-42`      |
| Timestamp         | `1784870400`        |

The generated tag is appended to the active address, for example:

```text theme={null}
david.nguyen+happy-fox-42@gmail.com
```

Use **Copy** for one alias or **Copy All** for the complete generated list. Generated aliases can be saved automatically according to the configured history limit.

## Create aliases from custom tags

Use **Custom Tags** when you want readable, reusable aliases.

<Steps>
  <Step title="Enter a tag">
    Enter a value such as `shopping`, `newsletter`, `work`, or `project-alpha`.
  </Step>

  <Step title="Generate and copy">
    Select **Generate**, then copy the resulting address.
  </Step>

  <Step title="Save frequent tags as presets">
    Add a label and tag in **Settings → Custom Presets**. Saved presets appear directly in the popup and context menu.
  </Step>
</Steps>

## Use Gmail tricks

The **Gmail Tricks** tab can generate several Gmail-compatible variations:

* **Dot Trick** — adds dots at different positions in the local part.
* **Plus Tags** — appends a `+tag` value.
* **Googlemail** — switches between `gmail.com` and `googlemail.com`.
* **Remove Dots** — removes all dots from the local part.
* **Dot + Plus** — combines a dot variation with a plus tag.
* **All Combos** — generates combinations of the supported tricks.

You can choose the number of variations and use sequential or randomized dot positions.

<Warning>
  Dot handling is a Gmail behavior, not a universal email standard. Do not assume the same result for Google Workspace or non-Gmail domains.
</Warning>

## Generate aliases inside websites

When supported, Gmail Alias Toolkit can show an inline icon next to email fields. Select it to open a quick alias generator without leaving the current website.

You can also right-click a page and use the Gmail Alias Toolkit context menu to create:

* A random alias.
* An alias from a saved preset.
* A dot variation.
* A `googlemail.com` variation.
* A version with all dots removed.

To hide the inline helper on a specific website, choose **Turn off the inline helper on this website**. Re-enable it later from **Settings → Disabled inline helper sites**.

## Manage aliases

The **Recent Aliases** area supports:

* Search by address or tag.
* Filter by tag or favorites.
* Sort by newest or alphabetically.
* Pagination for large histories.
* Multi-select deletion and export.
* CSV and JSON export.
* QR code generation for quick transfer to another device.
* Favorites for frequently reused aliases.

Open **Statistics** to review total generated aliases, aliases created today, this week, and this month, top tags, and activity over time.

## Configure the extension

From **Settings**, you can manage:

* Light, dark, or system theme.
* Toolbar badge counter mode.
* Copy notifications.
* Default random alias format.
* Automatic history limit.
* Custom presets.
* Accounts and active account.
* Settings import/export and reset.
* Disabled inline-helper websites.

<Note>
  Deleting an account also deletes its isolated history, favorites, and statistics. Export important data before removing an account.
</Note>


## Related topics

- [Usage](/google-cloud-skills-boost-helper/usage.md)
- [Features](/gmail-alias-toolkit/features.md)
- [ePlus.DEV Browser Extensions](/index.md)