# `mix ash.gettext.extract`
[🔗](https://github.com/ash-project/ash/blob/v3.24.3/lib/mix/tasks/ash.gettext.extract.ex#L5)

Extracts translatable error messages from Ash source files and generates
a `.pot` (Portable Object Template) file.

Scans for `error_message("...")` macro calls, recording each call site
with its file path and line number as standard gettext source references.

## Usage

    $ mix ash.gettext.extract

## Options

  * `--output` / `-o` — Path to write the `.pot` file.
    Defaults to `priv/gettext/ash.pot`.

  * `--domain` / `-d` — Gettext domain written into the file header.
    Defaults to `"ash"`.

## Workflow

This task is for Ash development. It regenerates `priv/gettext/ash.pot`
which is shipped with the hex package.

Users of Ash should run `mix ash.gen.gettext` to copy the `.pot` file
into their application.

---

*Consult [api-reference.md](api-reference.md) for complete listing*