<!-- prettier-ignore-start -->
# Job Step: ImportSiteArchive

**Type ID:** `ImportSiteArchive`  
**Scope:** Organization (add to an organization-level job flow)  
**Category:** Standard / system job step (Import)

Imports a site import archive file into the current instance.

This is a built-in (standard) job step provided by the B2C Commerce platform. Add it to a job flow in **Business Manager → Administration → Operations → Jobs**, or reference it by its type ID in a `jobs.xml` flow inside a site-import archive.

## Configuration Parameters

| Parameter | Required | Default | Allowed Values | Description |
| --- | --- | --- | --- | --- |
| `ImportFile` | Yes | — | — | Import file name located directly under 'IMPEX/src/instance' folder. |
| `ImportFromRealm` | No | `false` | — | If selected, the import file lookup will be taken in the global realm directory. |
| `ImportMode` | No | `merge` | `merge` | The import mode. |

## Working With IMPEX Files

This step reads files from the instance IMPEX area. `WorkingFolder` is resolved relative to `IMPEX/src/` (and defaults to `IMPEX/src/`); use `FileNamePattern` to select which file(s) to import. A prior step — custom or standard — that writes a file under `IMPEX/src/...` can hand off directly to this step. See the chaining example in the `b2c:b2c-custom-job-steps` skill.

## Related

- Run a job that uses this step: `b2c job run <job-id>` (see the `b2c-cli:b2c-job` skill).
- Author custom steps to chain with this one: `b2c:b2c-custom-job-steps` skill.
- Find more docs: `b2c docs search <term>` and `b2c docs read <id>`.

<!-- prettier-ignore-end -->
