---
schema_version: "1"
id: 06787a57992c4e2fdc4a83add2504a67026355b17f82d1324167f1557af1ceca
title: template generate lightning test
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/salesforcedx/sfclireference/guides/template/cli_reference_template_generate_lightning_test.md
canonical_url: https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_template_generate_lightning_test.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 57bd1efef3fa6546bc874d952be9f74e94ad1cc54723f1f394ce484fb6b23a10
products:
  - Salesforce CLI Command Reference
  - salesforcedx
---
<!-- prettier-ignore-start -->

# template generate lightning test

Generate a Lightning test.

## Description for template generate lightning test

Generates the test in the specified directory or the current working directory. The .resource file and associated metadata file are generated.

## Aliases for template generate lightning test

`force:lightning:test:create`

`lightning:generate:test`

## Flags

| Flag Name (Long) | Flag Name (Short) | Description |
|------------------|-------------------|-------------|
| <code>&#8209;&#8209;api&#8209;version</code> | N/A | **Type:** Value<br><br>Override the api version used for api requests made by this command |
| <code>&#8209;&#8209;flags&#8209;dir</code> | N/A | **Type:** Value<br><br>Import flag values from a directory. |
| <code>&#8209;&#8209;json</code> | N/A | **Type:** Boolean<br><br>Format output as json. |
| <code>&#8209;&#8209;name</code> | <code>&#8209;n</code> | **Type:** Value<br>**Required**<br><br>Name of the generated Lightning Test.<br><br>Name of the new Lightning test; can be up to 40 characters and must start with a letter. |
| <code>&#8209;&#8209;output&#8209;dir</code> | <code>&#8209;d</code> | **Type:** Value<br>**Default value:** `.`<br><br>Directory for saving the created files.<br><br>The location can be an absolute path or relative to the current working directory. The default is the current directory. |
| <code>&#8209;&#8209;template</code> | <code>&#8209;t</code> | **Type:** Value<br>**Valid Values:** `DefaultLightningTest`<br>**Default value:** `DefaultLightningTest`<br><br>Template to use for file creation.<br><br>Supplied parameter values or default values are filled into a copy of the template. For Lightning Web Components, if this flag isn't specified, the CLI command automatically selects the template based on the "defaultLwcLanguage" field in the DX project's "sfdx-project.json" file. |

## Examples for template generate lightning test

Generate the metadata files for the Lightning test called MyLightningTest in the current directory:

```shell
sf template generate lightning test --name MyLightningTest
```

Similar to the previous example but generate the files in the "force-app/main/default/lightningTests" directory:

```shell
sf template generate lightning test --name MyLightningTest --output-dir force-app/main/default/lightningTests
```
<!-- prettier-ignore-end -->