---
layout: docs
page_title: policy write - Command
description: |-
  The "policy write" command uploads a policy with name NAME from the contents
  of a local file PATH or stdin. If PATH is "-", the policy is read from stdin.
  Otherwise, it is loaded from the file at the given path on the local disk.
---

> [!IMPORTANT]  
> **Documentation Update:** Product documentation, which were located in this repository under `/website`, are now located in [`hashicorp/web-unified-docs`](https://github.com/hashicorp/web-unified-docs), colocated with all other product documentation. Contributions to this content should be done in the `web-unified-docs` repo, and not this one. Changes made to `/website` content in this repo will not be reflected on the developer.hashicorp.com website.

# policy write

The `policy write` command uploads a policy with name NAME from the contents of
a local file PATH or stdin. If PATH is "-", the policy is read from stdin.
Otherwise, it is loaded from the file at the given path on the local disk.

For details on the policy syntax, please see the [policy
documentation](/vault/docs/concepts/policies).

## Examples

Upload a policy named "my-policy" from "/tmp/policy.hcl" on the local disk:

```shell-session
$ vault policy write my-policy /tmp/policy.hcl
```

Upload a policy from stdin:

```shell-session
$ cat my-policy.hcl | vault policy write my-policy -
```

## Usage

There are no flags beyond the [standard set of flags](/vault/docs/commands)
included on all commands.