# project list ignored

Check your local project package directories for forceignored files.

## Description for project list ignored

When deploying or retrieving metadata between your local project and an org, you can specify the source files you want to exclude with a .forceignore file. The .forceignore file structure mimics the .gitignore structure. Each line in .forceignore specifies a pattern that corresponds to one or more files. The files typically represent metadata components, but can be any files you want to exclude, such as LWC configuration JSON files or tests.

## Aliases for project list ignored

`force:source:ignored:list`

## Flags

| Flag Name (Long) | Flag Name (Short) | Description                                                                                        |
| ---------------- | ----------------- | -------------------------------------------------------------------------------------------------- |
| `--flags-dir`    | N/A               | **Type:** Value<br><br>Import flag values from a directory.                                        |
| `--json`         | N/A               | **Type:** Boolean<br><br>Format output as json.                                                    |
| `--source-dir`   | `-p`              | **Type:** Value<br><br>File or directory of files that the command checks for foreceignored files. |

## Examples for project list ignored

List all the files in all package directories that are ignored:

```shell
sf project list ignored
```

List all the files in a specific directory that are ignored:

```shell
sf project list ignored --source-dir force-app
```

Check if a particular file is ignored:

```shell
sf project list ignored --source-dir package.xml
```