Citrix Virtual Apps and Desktops

Use Search in Studio


You can manage your Citrix Virtual Apps and Desktops deployment using two management consoles: Web Studio (web-based) and Citrix Studio (Windows-based). This article covers only Web Studio. For information about Citrix Studio, see the equivalent article in Citrix Virtual Apps and Desktops 7 2212 or earlier.

Use the search feature to view information about specific machines, sessions, machine catalogs, applications, or delivery groups. After selecting Search in Web Studio, you have several options:

  • Use tabs to list machines by type (single-session or multi-session OS), or list all sessions.
  • Enter the name in the search box.
  • Select the filter icon to perform an advanced search. Select the down arrow to display a list of search properties. Select the plus sign to build an expression from the properties in the list.

To save your search, select the ellipsis (…) icon and then select Save As. The search appears in the Saved searches list. (To access the list, select the search box.) To delete saved searches, select the search box and select Clear.

When you use filters to perform an advanced search, the Add filters window appears in the foreground, leaving the background view unchanged. After you select Search, the matched search results appear, with the filter criteria appearing next to Filter. When you close the Add filters window, the results remain there. To clear the filters, select the X icon next to the filter criteria.

Search for machine catalogs or delivery groups

You cannot perform searches from the Machine Catalogs or Delivery Groups node because the Search box is not available. Use the Search node instead to search for machine catalogs or delivery groups. On the Search node, select the filter icon, add filters as follows, and then select Search.

To show more search criteria in the display, select the plus sign. Remove search criteria by selecting the trash can icon.

Customize columns to display

When customizing columns, you can see columns marked with the Degrades performance label. Selecting those columns might degrade the performance of the console. After you complete your customization, the table refreshes to display the columns you select. Their presence might result in delays when you refresh the table.

If your customization contains columns that degrade performance, you are prompted to determine whether to preserve them. The prompt appears after you refresh the browser window or sign out of the console and then sign in. Be aware of the following considerations if you decide to preserve the columns:

  • To ensure console performance, you cannot refresh the table more than once a minute. This restriction applies to all tabs: Single-session OS Machines, Multi-session OS Machines, and Sessions. If you require more frequent refreshes, remove all columns that degrade performance.

Export search results to a CSV file

You can export your search results (up to 10,000 items) to a CSV file. The file is saved to the default download location of your browser.

This feature is available for both machines and sessions. To export your search results, click the export icon in the upper right corner. The export might take up to 1 minute to complete.

On each tab of the Search node, you cannot perform another export while an export is in progress.

Consider the following tips when using the Search feature:

  • On the Search node, select any column to sort items.

  • To show more characteristics to include in the display where you can search and sort, select Columns to Display or click any column and select Columns to Display. In the Columns to Display window, select the check box next to the items you want to display and select Save to exit.


    Items that degrade performance are marked with the Degrades performance label.

  • To locate a user device connected to a machine, use Client (IP) and Is, and enter the device IP address.

  • To locate active sessions, use Session State, Is, and Connected.

  • To list all machines in a delivery group, select Delivery Groups in the left pane. Select the group, and then select View Machines from the action bar or from the context menu.

Keep the following considerations in mind when performing sort operations:

  • As long as the number of items does not exceed 5,000, you can click any column to sort the items in it. When the number exceeds 5,000, you can sort only by name or by current user (depending on which tab you are on). To enable sorting, use filters to reduce the number of items to 5,000 or fewer.

  • When the number of items is greater than 500 but no more than 5,000:

    • We cache all data locally to improve sort performance. On the Single-session OS Machines and Multi-session OS Machines tabs, we cache the data the first time you click a column (any column except the Name column) to sort. On the Sessions tab, we cache the data the first time you click a column (any column except the Current User column) to sort. As a result, the sort takes longer to complete. For faster performance, sort by name or current user, or use filters to reduce the number of items.
    • The following message under the table indicates that the data is cached: Last refreshed: <the time when you refreshed the table>. In that case, sort operations are based on items that were loaded previously. Those items might not be up to date. To bring them up to date, click the refresh icon.
Use Search in Studio