Search Folders let admins save a set of search criteria as a folder. The folder’s contents update dynamically as items match or stop matching the criteria. You can use a Search Folder to make a curated set of content available from a Workspace without copying the items into another folder.
This guide covers creating a Search Folder, changing its criteria, and checking the results. For search operators, field names, and syntax examples, see Advanced Search | Working with Content and Workspaces.
Before you begin
- You need access to Airship and permission to create or edit folders.
- Decide which content the Search Folder should return. Search criteria can use text, metadata, item type, or other supported search fields.
- If you plan to search by metadata, confirm the field exists and is populated on the content you expect to find.
- Decide where the Search Folder should live. Search Folders inherit permissions from their parent folder, and users must also have access to matching items in their original locations.
Create a Search Folder
- In Airship, open the location where you want the Search Folder to live.
- Select Create > Folder.
- In the folder-creation window, select the option to set the folder as a Search Folder.
- Enter a name for the folder and configure any other folder details.
- Add the search criteria:
- Use Add Search Parameter and the visual editor to build a straightforward search.
- For more complex criteria, use Show Advanced or the Advanced Query input to edit the search expression directly. The visual editor reflects changes as you type.
- Save the Search Folder.
- Open it and review the returned items to confirm the criteria match your intent.
For a simple metadata-based search, choose the metadata field, select an operator such as Equals or Contains, and provide the value. Use Equals for an exact metadata value; Contains can match part of a value. Available options depend on your environment and metadata configuration.
Update a Search Folder
- In Airship, locate and open the Search Folder you want to change.
- Choose the option to edit its search parameters.
- Update the criteria in the visual editor, or switch to the advanced controls for more complex logic.
- Save your changes.
- Open the Search Folder again and check the results. Confirm that expected items appear and that unrelated items are excluded.
Because a Search Folder is based on saved criteria, changing those criteria changes which items it returns. It does not move or copy the matching items.
Combine criteria
Use AND when an item must meet multiple conditions. Use OR when either condition is sufficient. Parentheses group conditions and control how a combined expression is evaluated.
For example, this expression returns items for a specified audience when they are either PDF or Word documents:
- audience EQUALS "Customer-facing" AND (type EQUALS "pdf" OR type EQUALS "docx")
For supported fields, operators, quoting rules, and additional examples, see Advanced Search | Working with Content and Workspaces.
Check access and results
- Search Folders do not grant access to the content they find. Users only see matching items if they already have permission to view those items in their original locations.
- Search Folders inherit folder permissions from their parent folder. To control who can access a Search Folder, place it in a parent folder with the appropriate permissions.
- If expected items are missing, verify the search field and value, confirm the metadata is populated, and check the user’s permissions to the original item.
- If unexpected items appear, review each condition and the AND / OR grouping. For complex logic, check that parentheses group the conditions as intended.
For general folder setup and permissions, see Creating and managing Folders.
Replies have been locked on this page!