---
title: New-File
product: Unity Gaming Services CLI
version: 2.0.0
latest_version: 2.0.0
status: This page documents version 2.0.0. The latest version is 2.0.0.
canonical: https://docs.unity.com/en-us/services-cli/2.0.0/manual/matchmaker/commands/new-file
latest_url: https://docs.unity.com/en-us/services-cli/2.0.0/manual/matchmaker/commands/new-file.md
last_updated: 2026-10-01
generated_at: 2026-11-17T05:28:17.519Z
locale: en-us
---

# New-File

> Creates a new Matchmaker configuration file locally filled with template code.

Creates a new Matchmaker configuration file locally filled with template code.

The template uses `MatchId` match hosting.

## Command

Authentication Required: `No`

```bash
ugs matchmaker new-file <file-name> [options]
```

## Arguments

`<file-name>` The name of the file to create

## Options

|       | Alias          | Description                         |
| ----- | -------------- | ----------------------------------- |
| force | -f, --force    | Overwrites existing file            |
| help  | -?, -h, --help | Display help and usage information. |
| quiet | -q, --quiet    | Reduce logging to a minimum.        |
| json  | -j, --json     | Use JSON as the output format.      |
