--- 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 ``` ***