docs: added "Products Overview" user guide (#2082)
* docs: added products overview * docs: small changes to orders overview
This commit is contained in:
Shahed Nasser
GitHub
@@ -0,0 +1,166 @@
|
||||
import UiIcon from '@site/src/components/UiIcon';
|
||||
|
||||
# Products Overview
|
||||
|
||||
In this document, you’ll get an overview of the product listing page and all the things you can do with it.
|
||||
|
||||
## View List of Products
|
||||
|
||||
You can view the list of available products in your ecommerce store by clicking on Products from the sidebar menu.
|
||||
|
||||
|
||||
|
||||
In the list, you can see product details such as the name, collection, inventory, and status of the product.
|
||||
|
||||
:::tip
|
||||
|
||||
If there are more than 15 products, the list will be split into multiple pages. You can navigate between pages by clicking the arrows at the bottom of the list.
|
||||
|
||||
:::
|
||||
|
||||
## Change Product View
|
||||
|
||||
### List View
|
||||
|
||||
To view products in a list view, which is the default view, click on the <UiIcon lightIcon="https://i.imgur.com/2Bxfaoo.png" darkIcon="https://i.imgur.com/1wfhnFV.png" alt="list" /> icon at the top right of the product list.
|
||||
|
||||
### Grid View
|
||||
|
||||
To view products in a grid view, click on the <UiIcon lightIcon="https://i.imgur.com/cXeBavT.png" darkIcon="https://i.imgur.com/jPUgY9C.png" alt="grid" /> icon at the top right of the product list.
|
||||
|
||||
|
||||
|
||||
## View List of Collections
|
||||
|
||||
Collections are used to split products based on their type or function. For example, if you sell furniture and clothing, you can have two collections: Furniture and Clothing.
|
||||
|
||||
You can view the list of collections on the Products page by clicking on the grey Collections headline next to the Products headline.
|
||||
|
||||
|
||||
|
||||
In the list, you can see collection details such as the title, handle, and the number of products in the collection.
|
||||
|
||||
:::tip
|
||||
|
||||
If there are more than 15 collections, the list will be split into multiple pages. You can navigate between pages by clicking the arrows at the bottom of the list.
|
||||
|
||||
:::
|
||||
|
||||
## Filter Products
|
||||
|
||||
You can use filters to retrieve only products matching specific criteria.
|
||||
|
||||
### Quick Filters
|
||||
|
||||
On the Products list page, you can find quick filters such as “Unpublished” at the top of the list. The “Unpublished” filter shows only draft products in the list.
|
||||
|
||||
You can click on these filters to quickly filter the products.
|
||||
|
||||
|
||||
|
||||
### Advanced Filters
|
||||
|
||||
You can use advanced filters to furthermore limit the products shown based on specific criteria. For example, you can filter products to only show draft products created in a specific collection.
|
||||
|
||||
To use advanced filters:
|
||||
|
||||
- Click on the <UiIcon lightIcon="https://i.imgur.com/alMqdZW.png" darkIcon="https://i.imgur.com/He8m6qd.png" alt="plus" /> icon next to Filters. This will toggle a dropdown with categories for different fields.
|
||||
- You can click on a field name to expand it and choose a filter for that field.
|
||||
- Click on the Apply button at the top of the dropdown.
|
||||
|
||||
This will retrieve the products based on the filters you’ve selected.
|
||||
|
||||
|
||||
|
||||
### Save Advanced Filters as Quick Filters
|
||||
|
||||
If there are filters that you need to use frequently, you can give the set of filters a name and save them to be used later. For example, you can save the filters used in the previous example as “Draft Clothing”.
|
||||
|
||||
To save an advanced filter:
|
||||
|
||||
- Click on the <UiIcon lightIcon="https://i.imgur.com/alMqdZW.png" darkIcon="https://i.imgur.com/He8m6qd.png" alt="plus" /> icon next to Filters.
|
||||
- Choose your filters from the dropdown.
|
||||
- Choose a name for the filters in the input at the end of the dropdown.
|
||||
- Click the Save button.
|
||||
|
||||
|
||||
|
||||
Once you click Save, you should see the new filter you added next to the Quick Filters at the top of the orders list.
|
||||
|
||||
|
||||
|
||||
To apply a saved quick filter, just click on it.
|
||||
|
||||
### Delete Saved Quick Filters
|
||||
|
||||
You can delete any saved filter you’ve created. To do that, simply click on the <UiIcon lightIcon="https://i.imgur.com/FFwnF0m.png" darkIcon="https://i.imgur.com/ZZN7BfE.png" alt="X" /> icon next to the quick filter’s name, and it will be deleted.
|
||||
|
||||
### Clear Filters
|
||||
|
||||
To clear all applied filters:
|
||||
|
||||
- Click on the <UiIcon lightIcon="https://i.imgur.com/alMqdZW.png" darkIcon="https://i.imgur.com/He8m6qd.png" alt="plus" /> icon next to Filters.
|
||||
- Click on the Clear button.
|
||||
|
||||
|
||||
|
||||
:::info
|
||||
|
||||
Clearing filters does not delete saved quick filters. You can still apply them by clicking on them.
|
||||
|
||||
:::
|
||||
|
||||
## Search Products
|
||||
|
||||
You can search for products by clicking the <UiIcon lightIcon="https://i.imgur.com/efyG8WQ.png" darkIcon="https://i.imgur.com/NgocLvX.png" alt="magnifier" /> icon at the top right of the products list. When you search products, you search by product title, description, variant title, variant SKU, and collection title.
|
||||
|
||||
|
||||
|
||||
## Search Collections
|
||||
|
||||
You can search for collections by clicking the <UiIcon lightIcon="https://i.imgur.com/efyG8WQ.png" darkIcon="https://i.imgur.com/NgocLvX.png" alt="magnifier" /> icon at the top right of the collections list. When you search collections, you search by collection title and handle.
|
||||
|
||||
|
||||
|
||||
## Export Products
|
||||
|
||||
To export products:
|
||||
|
||||
- Go to the Products page.
|
||||
- Click on Export Products at the top right.
|
||||
- Click Export in the window that opens.
|
||||
- Click on the <UiIcon lightIcon="https://i.imgur.com/u7dU3tC.png" darkIcon="https://i.imgur.com/dlrSybv.png" alt="bell" /> icon at the top right of the page.
|
||||
- You should see your new export loading.
|
||||
- Once the export is ready, click on the Download button.
|
||||
|
||||
:::note
|
||||
|
||||
If you face any errors or difficulties, please contact your technical support team as this could be an issue in the storage integration used.
|
||||
|
||||
:::
|
||||
|
||||
|
||||
|
||||
### Cancel a Product Export
|
||||
|
||||
You can only cancel an unfinished product export.
|
||||
|
||||
To cancel a product export:
|
||||
|
||||
- Click on the <UiIcon lightIcon="https://i.imgur.com/u7dU3tC.png" darkIcon="https://i.imgur.com/dlrSybv.png" alt="bell" /> icon at the top right of the page.
|
||||
- Find the export you want to cancel.
|
||||
- Click on the cancel button.
|
||||
|
||||
|
||||
|
||||
### Delete a Product Export
|
||||
|
||||
You can only delete a finished product export.
|
||||
|
||||
To delete a product export:
|
||||
|
||||
- Click on the <UiIcon lightIcon="https://i.imgur.com/u7dU3tC.png" darkIcon="https://i.imgur.com/dlrSybv.png" alt="bell" /> icon at the top right of the page.
|
||||
- Find the export you want to delete.
|
||||
- Click on the Delete button.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user