# Resource List
The **Resource List** widget is used to display various types of Foundry resources:
## Files and Projects resources
This type of list is used to display collections of Files and Projects resources, either fixed statically or generated dynamically for every user viewing the widget, in accordance with existing Files and Projects hierarchy and permissions.
When the **Files and Projects resources** option is chosen from the **Type of the Resource list** dropdown menu in the widget's configuration, you can also select a subtype of resources using the **Content of the Resource list** menu:
* Static: users can manually define a list of resources to display in the list.
* Dynamic:
* Recent: resources that have been recently interacted with by the user.
* Favorite: resources that have been favorited by the user.
* Folders: resources located in a list of projects and/or folders specified by the user.
* Tags: users can specify a list of tags so that resources that have one of these tags will be displayed.
## Object types
This type of list is used to display collections of object types, either fixed statically or generated dynamically for every user viewing the widget, in accordance with existing Ontology permissions and settings.
When the **Object types** option is chosen, you can choose one of the following subtypes from the **Content of the Object type list** menu:
* Static: users can manually define a list of object type resources to be displayed.
* Dynamic:
* All: every object type visible to the user in the Ontology.
* Prominent: object types that are visible to the user that have been marked as prominent.
* Favorite: object types that have been favorited by the user.
## Object sets
This type of list is used to display a statically fixed collection of object sets, where each item is backed by a [Workshop object set variable](../concepts-variables/index.md). To create an Object set list, choose the **Object sets** option from the top-level dropdown in the widget's configuration.
The Resource list widget also supports a number of interactions and display options, including:
* Two item formats:
* List
* Image cards
* Three display styles:
* Minimal
* Prominent
* Classic
To customize an item's display, select that item in the widget's configuration editor and toggle on the Display Overrides section. The following metadata can be specified or overridden:
* Title: Can be overridden with a static string or a string variable.
* Description: Can be overridden with a static string or a string variable.
* Style: Can be overridden with a choice of minimal, classic, or prominent.
* Icon: Can be overridden with a choice of the name and a predefined or custom color.
* Item visibility: A Boolean variable can be chosen to control the visibility of the item. If the value is *false*, the item will be hidden on the list.
* Thumbnail (only with image card format): An image resource from Files and Projects can be chosen here. The resource has to be uploaded to Foundry first.
* Thumbnail position (only with image card format): Can be overridden with a choice of top, right, bottom, or left.
## Integration with Workshop variable and eventing framework
Each item on the Resource list is interactive. The action performed will depend on the type of the list:
* For the Files and Projects Resource list, selecting a resource item will open that resource in the default Foundry application for that resource in a new browser tab. If the user is in a [Carbon](../../carbon/overview/index.md) workspace and the resource can be opened in Carbon, the resource will open in new Carbon tab.
* An item representing a dataset will be opened in the [Dataset Preview](../../dataset-preview/overview/index.md) application in a new browser tab. Since datasets cannot be opened directly in Carbon, they will always open in Dataset Preview.
* An item representing a Slate dashboard will be opened in a [Slate application](../../slate/overview/index.md) in a new browser tab, or in a new Carbon tab if user is in Carbon.
* For the object types Resource list, selecting an object type item will open a new exploration [Object Explorer](../../object-explorer/overview/index.md) seeded with all objects of that object type. The new exploration will be opened in a new browser tab, or in a new Carbon tab, if user is in Carbon.
* For the object set Resource list, selecting an object set item will open that object set in [Object Explorer](https://www.palantir.com/object-explorer/overview.md) in a new browser tab, or in a new Carbon tab, if user is in Carbon.
For all types of the Resource list, you can override the default action when the widget displays a static list of items. In widget's configuration editor, select the item and add any number of standard [Workshop Events](../concepts-events/index.md). Use the **On selection of resource** for Files and projects resources, **On selection of object type** for object type resources, and **On selection of object set** for object set resources.
You can reference the selected object type item or object set item itself in the Event configuration if the **Selected object type** or **Selected object set** variable is set in the main widget configuration for the correct type. Refer to [Workshop Events](../concepts-events/index.md) for more information on using variables in Events.
In the **Selected object type** or **Selected object set** section of the main widget configuration, you can set the variable that will contain the value of the selected object type or object set.
Navigate to the configuration of a specific item by selecting that item in the **Content of the resource list** section. Then use the configured **Selected object type** or **Selected object set** variable in the Event configuration. In the example below, the variable is a parameter for the **Open Object explorer** Event.