// Module included in the following assemblies:
//
// * virt/managing_vms/virt-list-vms.adoc

:_mod-docs-content-type: PROCEDURE
[id="virt-listing-vms-web_{context}"]
= List virtual machines by using the web console

[role="_abstract"]
You can list all of the virtual machines (VMs) in your cluster by using the web console.

.Procedure

. Click *Virtualization* -> *VirtualMachines* from the side menu to access the tree view of all projects and VMs in your cluster.

. Optional: Enable the *Show only projects with VirtualMachines* option above the tree view to limit the displayed projects.

. Select a project or cluster in the tree view to automatically filter the VM list to that selection.

. Click the *Virtual machines* tab.

. Optional: Click the *Search virtual machines* text box and begin to type the name of a virtual machine. A list of filtered virtual machine names will appear and change as you type.

. Optional: Click the *Advanced search* button next to the search bar to use more search options.

.. Use the fields provided to further filter your virtual machine search.
+
[cols="1,1a", options="header"]
|===
|Field |Description

| Name
| The virtual machine name.

| Project
| A project that is part of your deployment.

| Description
| Text in the description of the virtual machine.

| Status
| The status of the virtual machine.

| Operating system
| The operating system of the virtual machine.

| vCPU
| The number of vCPUs allotted to the virtual machine. Select a modifying expression and enter a value to search on.

| Memory
| The amount of memory allotted to the virtual machine. Select a modifying expression, enter a value to search on, and select what that value represents.

| Storage class
| The storage class the virtual machine uses.

| Hardware devices
| The type of hardware device associated with the virtual machine.

| Date created
| The date range the virtual machine was created in.

| Labels
| The labels associated with the virtual machine.

| Scheduling
| The scheduling logic associated with the virtual machine.

| Nodes
| The nodes associated with the virtual machine.

| IP address
| The IP address of the virtual machine.

| Network Attachment Definitions
| Select the appropriate definition.

|===

.. Click *Search*.

.. Optional: Click *Clear all* to clear all search criteria.

. Optional: Click *Save search* to save the current for reuse later.

. Optional: Select a saved search from the *Saved searches* list to reuse.

. Optional: Filter the list of virtual machines by project or cluster by using the *Project* or *Cluster* list.

. Optional: Filter the list of virtual machines by status using the *Status* list.

. Optional: Filter the list of virtual machines by operating system using the *Operating system* list.

. Optional: Filter the list of virtual machines by name using the *Search by name* field.

. Optional: Use the *Selection* list to quickly select or deselect a group of virtual machines.

. Optional: Use the *Actions* list to perform an action on all selected virtual machines.

. Optional: Click the *More actions* icon beside an individual virtual machine listing to perform an action on that virtual machine.
