Dev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunitySubmit a ticketLog In
GitHubNuGetDev CommunitySubmit a ticket

Website users may create Lists to save and manage products they plan to purchase in the future or keep a static list of products they purchase frequently. These lists can be accessed on the website under **My Account**.

## List settings

  • **Allow Multiple Lists** – Yes/No values - If Yes, the website prompts users to choose a list or create a new one when adding a product to a list; users may copy lists; and a page with a summary of all user lists is accessible under My Account. If no, the user is allowed only one list, and lists may not be copied or shared.

  • **Allow List Sharing** – Yes/No values - If Yes, list owners can send a copy of their list to others, or invite others to view or edit a list.


    If Allow Multiple Lists is set to No, Allow List Sharing is hidden.

  • Setting **Wishlists by Customer** has been deprecated, and is no longer available.

## Access lists

To access lists, log in to the website as a website user, or impersonate a user through the Admin Console's Impersonate function. Hover over the **My Account** menu, and select **My Lists**.

  • Click a list's linked name to view the list's Details Page.

  • Select one of the items shown to access the item's Product Details Page.

  • Select the **Shared with...** or **Shared by...** links to manage or view sharing permissions

  • Choose a **Sort By** option from the drop-down to sort the lists by Last Updated, List Name: A-Z, or List Name: Z-A.

  • Select **Create List** to create a new list.

  • Select **Add List To Cart** to add all items to the cart at the specified quantities. If the list has no purchasable items in it, this button is grayed out.

  • Click **Delete List** to delete the list. On a list that has been shared with this user, this link changes to **Leave List.**

## List details page

Select the list's linked name to view the list's Details Page. Use this page to modify a specific list, copy it, or share it with others.

### List action buttons

  • Select **Copy** to copy the list's items to a new or existing list. Select an existing list, or enter a new list name. Click **Copy to List**.


    Copying items to another list does not remove them from the current list.

  • Select **Share** to send a copy of the list to selected users, or to allow selected users to view or edit the list. See **Share a List** for more information on sharing.

  • Select **Delete** to delete the list. If the user is accessing a list that has been shared with them, and they do not have editing permissions, this button does not appear.

  • Select **Edit** to edit the list name and description. If the user is accessing a list that has been shared with them, and they do not have editing permissions, this button does not appear.

### Other list actions

  • If the list is being shared with others, select **Shared with...** at the top of the screen to edit sharing permissions for the list.

  • Select **Add Items** to reveal a drop-down like the Quick Order widget. Search for an item by keyword or item number, enter the quantity and unit of measure (if applicable), and click **Add To List**. Or, select **Upload Items** to upload an Excel or CSV file of products.

  • Select **Add List to Cart** to add all items in the list to the cart.


    This action does not remove the items from the list.

  • Select the **Select All** checkbox to select all items in the list, or select individual check boxes to choose a specific number of items. Click **Add To Cart** to add the selected items to the cart, or **Delete** to delete the selected items. These action buttons appear at both the top and bottom of the list. You should complete these actions before moving to another list page for any selected items, as they only apply to selections on the current page.

  • Use the **Search bar** to narrow list results by keyword or item number.

  • Select the **Sort By** drop-down to sort the list by Custom Sort, Date Added, Product: A-Z (product name field), or Product: Z-A (product name field). If Custom Sort is selected, click and drag the up and down arrows to arrange products manually. This order is retained, and reappears whenever Custom Sort is selected.

If a product is no longer available due to being deactivated or discontinued, a message appears notifying the user the products has been removed from the list. If products are unavailable due to product restrictions set on the user's active customer, a notification appears at the top and allows the user to elect whether to remove the products from the list.

## Create a new list

There are multiple ways to create a new list. The most common is creating a new list from the Product Detail Page. After accessing the website as a user, or impersonating a user using the Admin Console's Impersonate functionality, complete the following:

  1. To create a new list from the Product Detail Page, browse or search for a product.

  2. Select **Add to List** .

  3. Select a list from the drop-down, or create a new list.

  4. Click **Add to List**.

Alternately, go to **My Account** \> **My Lists**, and select **Create List.**