---
title: Resource list
description: >-
When merchants need to browse and select from a collection of similar items, a
resource list provides a compact, scannable format. It helps merchants find an
object and navigate to its full-page representation.
api_name: app-home
source_url:
html: 'https://shopify.dev/docs/api/app-home/patterns/compositions/resource-list'
md: 'https://shopify.dev/docs/api/app-home/patterns/compositions/resource-list.md'
---
# Resource list
When merchants need to browse and select from a collection of similar items, a resource list provides a compact, scannable format. It helps merchants find an object and navigate to its full-page representation.
Use resource lists for smaller collections, or when you need a simpler selection interface within a card or modal. This composition follows proven design guidelines that help your app feel native to the Shopify admin. See [Built for Shopify requirements](https://shopify.dev/docs/apps/launch/built-for-shopify/requirements) for more details on these guidelines for apps.
#### Use cases
* Displaying collections of campaigns, subscribers, or templates
* Helping merchants search and filter to find items
* Enabling bulk actions on selected resources
***
## Examples
### Provide search, filtering, and row selection for a resource list
Merchants need to browse and select from a collection of items and navigate to details. This pattern provides search, filtering, and row selection for a resource list. The [text field](https://shopify.dev/docs/api/app-home/web-components/forms/text-field) uses `icon="search"` for filtering, the [popover](https://shopify.dev/docs/api/app-home/web-components/overlays/popover) holds filter options, and the [checkbox](https://shopify.dev/docs/api/app-home/web-components/forms/checkbox) enables row selection.
##### jsx
```tsx
Tagged with
Clear
Save
Tagged with VIP
Newest update
Oldest update
Mae Jemison
Decatur, USA
Ellen Ochoa
Los Angeles, USA
```
##### html
```html
Tagged with
Clear
Save
Tagged with VIP
Newest update
Oldest update
Mae Jemison
Decatur, USA
Ellen Ochoa
Los Angeles, USA
```
### Add items with Resource Picker API
Use the [Resource Picker API](https://shopify.dev/docs/api/app-home/apis/resource-picker) to let merchants add products from their catalog to the list.
##### jsx
```tsx
{
const selected = await shopify.resourcePicker({
type: 'product',
multiple: true,
});
if (selected) {
console.log('Selected products:', selected);
}
}}
>
Add products
Showing 2 products
Newest
Oldest
Mountain View
16 pieces
Ocean Sunset
9 pieces
```
##### html
```html
Add products
Showing 2 products
Newest
Oldest
Mountain View
16 pieces
Ocean Sunset
9 pieces
```
### Confirm delete with Modal API
Use the [Modal API](https://shopify.dev/docs/api/app-home/apis/modal-api) to confirm deletion before removing a resource list item.
##### jsx
```tsx
Newest update
Oldest update
Mae Jemison
Decatur, USA
Ellen Ochoa
Los Angeles, USA
Are you sure you want to delete this customer? This action cannot be undone.
Delete
Cancel
```
##### html
```html
Newest update
Oldest update
Mae Jemison
Decatur, USA
Ellen Ochoa
Los Angeles, USA
Are you sure you want to delete this customer? This action cannot be undone.
Delete
Cancel
```
### Navigate to item detail
Use `href` attributes on clickable items to navigate merchants to detail pages.
##### jsx
```tsx
Showing 2 customers
Newest update
Oldest update
Mae Jemison
Decatur, USA
Ellen Ochoa
Los Angeles, USA
```
##### html
```html
Showing 2 customers
Newest update
Oldest update
Mae Jemison
Decatur, USA
Ellen Ochoa
Los Angeles, USA
```
### Show action feedback with Toast API
Use the [Toast API](https://shopify.dev/docs/api/app-home/apis/toast) to show feedback when actions are performed on resource list items.
##### jsx
```tsx
{
shopify.toast.show('Filters saved');
}}
>
Save filters
Newest update
Oldest update
Mae Jemison
Decatur, USA
{
shopify.toast.show('Customer archived');
}}
>
Archive
{
shopify.toast.show('Customer deleted', { isError: true });
}}
>
Delete
Ellen Ochoa
Los Angeles, USA
```
##### html
```html
Save filters
Newest update
Oldest update
Mae Jemison
Decatur, USA
Archive
Delete
Ellen Ochoa
Los Angeles, USA
```
***