---
title: "view bulk-permission-update"
slug: "view-bulk-permission-update"
tags: ["5.5"]
updated: 2026-10-27T23:00:54Z
published: 2026-10-27T23:00:54Z
canonical: "docs.vastdata.com/view-bulk-permission-update"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vastdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# view bulk-permission-update

This command lets you set up and run a bulk permission update on a view.

## Usage

```plaintext
view bulk-permission-update --id ID
                            --target-path PATH 
                            --template-view-id TEMPLATE_ID
                            --template-dir-path TEMPLATE_DIR_PATH
                            [--template-file-path TEMPLATE_FILE_PATH]
```

## Required Parameters

| `--id ID` | Specify the ID of the view that exposes the files and directories for which you want to update permissions. |
| --- | --- |
| `--target-path PATH` | Specify a view path where files and directories for which to update permissions reside. |
| `--template-view-id TEMPLATE_ID` | Specify a view that exposes a directory and (optionally) a file from which to copy permissions and ownership attributes. This view should be on the same tenant as the view specified on `--target-path`. It is strongly recommended that the target view and the template view have view policies with the same security flavor. Running a bulk permission update on a view where the security flavor does not match that of the template view may result in inaccessible or incompatible permissions set. |
| `--template-dir-path TEMPLATE_DIR_PATH` | Specify a path to the directory from which to copy permissions and ownership attributes to the directories under `--target-path`. For more information about choosing a template directory, see [Running a Bulk Permission Update](/docs-5-5/docs/managing-views#running-a-bulk-permission-update). |

## Options

| `--template-file-path TEMPLATE_FILE_PATH` | Specify a path to the file from which to copy permissions and ownership attributes to the files under `--target-path`. If not specified, the attributes are copied from the directory specified on `--template-dir-path`. For more information about choosing a template file, see [Running a Bulk Permission Update](/docs-5-5/docs/managing-views#running-a-bulk-permission-update). |
| --- | --- |

## Example

After the following command is run, all directories under `/mydir/test` on view 7 will have permissions and ownership as of `/template` on view 1, and all files under `/mydir/test` on view 7 will have permissions and ownership as of `/template.txt` on view 1:

```plaintext
vcli: admin> view bulk-permission-update --id 7 --target-path /mydir/test --template-view-id 1 --template-dir-path /template --template-file-path /template.txt
```