# View

Location: [gRPC API](https://developer.m-files.com/APIs/gRPC-API/index.md) > [Reference](https://developer.m-files.com/APIs/gRPC-API/Reference/index.md) > [Messages](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/index.md)

HTML version: https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.View/

Struct for a single view.

- **Full name:** `MFiles.View`
- **Proto file:** [`mfiles/structs.proto`](https://developer.m-files.com/APIs/gRPC-API/downloads/proto/mfiles/structs.proto)

<a id="fields"></a>

## Fields

| Field | Type | Number | Description |
|---|---|---|---|
| <a id="f-id"></a>`id` | `int32` | 1 | The ID of the view. |
| <a id="f-type"></a>`type` | [`ViewType`](https://developer.m-files.com/APIs/gRPC-API/Reference/Enums/MFiles.ViewType/index.md) | 2 | The type of the view. Values: `VIEW_TYPE_SHOW_OBJECTS` (0), `VIEW_TYPE_FILTER_ONLY` (1). |
| <a id="f-name"></a>`name` | `string` | 3 | The name of the view. |
| <a id="f-is_common"></a>`is_common` | `bool` | 4 | Tells if the view is admin-defined (common) or user-defined. |
| <a id="f-is_visible"></a>`is_visible` | `bool` | 5 | Tells if the view is visible. |
| <a id="f-location"></a>`location` | [`ViewLocation`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.ViewLocation/index.md) | 6 | The location of the view. Valid only if bHasParent is true. |
| <a id="f-content_definition"></a>`content_definition` | [`SearchDef`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.SearchDef/index.md) | 7 | The search definition that contains the view levels and search conditions of the view. |
| <a id="f-acl"></a>`acl` | [`AccessControlList`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.AccessControlList/index.md) | 8 | Permissions. |
| <a id="f-flags_obsolete"></a>`flags_obsolete` | `uint32` | 9 | Bit flags that provide additional information on the view. |
| <a id="f-options"></a>`options` | [`VIEWFLAGS`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.VIEWFLAGS/index.md) | 11 | Bit flags that provide additional information on the view. |
| <a id="f-guid"></a>`guid` | `string` | 10 | GUID for the view. |
| <a id="f-view_visualization"></a>`view_visualization` | [`ViewVisualization`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.ViewVisualization/index.md) | 12 | View visualization information. |

<a id="used-by-methods"></a>

## Used by methods

- [IRPCSearch.GetFolderContents](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCSearch/GetFolderContents/index.md): Lists the contents of a view or a view level: subviews, grouping folders and objects.
- [IRPCViews.AddNewView](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCViews/AddNewView/index.md): Creates a new private or common view.
- [IRPCViews.CopyView](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCViews/CopyView/index.md): Copies a private view that another user has shared, with its child views, into the caller's own views.
- [IRPCViews.GetViews](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCViews/GetViews/index.md): Gets the calling user's view collection: all views, or the direct child views of one view.
- [IRPCViews.ModifyView](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCViews/ModifyView/index.md): Replaces the definition of an existing view.
- [IRPCViewsAdmin.GetViewsAndUsersAdmin](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCViewsAdmin/GetViewsAndUsersAdmin/index.md): Gets all common views and the private views of all users, with the owner of each private view.
- [IRPCWorkspace.CreateTemporaryWorkspaceView](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCWorkspace/CreateTemporaryWorkspaceView/index.md): Builds the definitions of a new workspace tab view and its reverse view for a pair of object types, without saving the views.

<a id="used-in-fields"></a>

## Used in fields

- [`FolderDataUnion.ViewFolderData.view`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.FolderDataUnion/index.md#t-ViewFolderData-view): The view.
- [`PropertyFolderWithParent.last_parent_view`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.PropertyFolderWithParent/index.md#f-last_parent_view): The last view and search conditions from the parent folder.
- [`ViewsOrDelta.views`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.ViewsOrDelta/index.md#f-views): Views. This contains inserted or updated views if this struct represents a delta, otherwise it contains just a "normal" array of views.
- [`ViewsOrDeltaEx.views`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.ViewsOrDeltaEx/index.md#f-views): Views. This contains inserted or updated views if this struct represents a delta, otherwise it contains just a "normal" array of views.
- [`ViewWithParentLocation.value`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.ViewWithParentLocation/index.md#f-value): Resulting the view.
- [`GetFolderContentsResponse.view_folders`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCSearch/GetFolderContents/index.md#response): Resulting views array.
- [`AddNewViewRequest.utf8szview`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCViews/AddNewView/index.md#request): The new view. Set at least `name`, `type`, `is_common`, `is_visible` and `content_definition`; for a common view also `acl`. `id` and `guid` are ignored.
- [`AddNewViewResponse.new_view`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCViews/AddNewView/index.md#response): The view as stored, with its new ID and GUID.
- [`ModifyViewRequest.utf8szview`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCViews/ModifyView/index.md#request): The complete new definition of the view, with the `id` of the view to change.
- [`GetViewsResponse.views`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCViews/GetViews/index.md#response): The views. See [View](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.View/index.md).
- [`CopyViewResponse.putf8szviews`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCViews/CopyView/index.md#response): The new view and its copied child views.
- [`GetViewsAndUsersAdminResponse.user_defined_views`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCViewsAdmin/GetViewsAndUsersAdmin/index.md#response): The private views of all users. See [View](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.View/index.md).
- [`GetViewsAndUsersAdminResponse.u_common_views`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCViewsAdmin/GetViewsAndUsersAdmin/index.md#response): All common views.
- [`CreateTemporaryWorkspaceViewResponse.view`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCWorkspace/CreateTemporaryWorkspaceView/index.md#response): The tab view, not yet saved.
- [`CreateTemporaryWorkspaceViewResponse.reverse`](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCWorkspace/CreateTemporaryWorkspaceView/index.md#response): The view in the reverse direction, not yet saved.