Bonzai 2 - Modern SharePoint Intranet

Display any SharePoint list as a searchable, filterable catalog with grid or list layouts.

ListsFeature Parity: 85%

Get Marketplace Working in 3 Steps

20-30 minutes

Prerequisites

Bonzai 2 package installed on your site
A SharePoint list with items to display

Add the web part to your page

Edit the page, click the + button, and search for "Marketplace" in the Bonzai category.

Select your list

Open the property pane, select your SharePoint list from the dropdown picker.

Configure columns and publish

Toggle which columns to display, set layout options, and publish your page.

Dynamic Schema Discovery

Unlike traditional web parts that require specific list schemas, Marketplace automatically discovers columns from any SharePoint list. Just point it at your list and toggle which fields to display.

When to Use This Web Part

Use this when you need to...

Display IT service catalog or help desk offerings
Create an internal product or equipment inventory
Build a knowledge base or FAQ directory
Show office supplies or asset catalog
Display any structured list data with search and filtering

Best page locations

Service catalogs — IT services, HR resources, facilities
Inventory pages — equipment, supplies, assets
Directory listings — vendors, partners, resources
Knowledge bases — FAQs, policies, procedures

Consider alternatives when...

• Document libraries — use Documents Rollup instead
• News articles — use News Rollup instead
• People/employees — use Employee Directory instead
• Events with dates — use Events Rollup instead

Related web parts:

Documents Rollup — displaying files from document librariesAdvanced Links — simple link tiles without list dataLanding — manually curated content cards

Layout Templates

Marketplace supports two display layouts:

Grid (Tiles)Card-based grid with 2-5 columns per row — best for visual catalogs

List (Rows)Compact row-based layout — best for data-dense listings

Key Features

Search

Filter items by title with debounced search

Category Filtering

Auto-discovered from Choice columns

Sorting

Sort by any sortable column, ascending or descending

Create New

Button opens SharePoint new item form

Step-by-Step Configuration

Create or identify your SharePoint list

Marketplace works with any SharePoint list. Create a new list or use an existing one with the data you want to display.

Add a Choice column for categories — Marketplace will auto-discover it for filtering.

Edit your SharePoint page

Navigate to the page where you want to add the Marketplace. Click "Edit" in the top right corner.

Add the Marketplace web part

Click the + button in any section, type "Marketplace" in the search box, and select "Bonzai Marketplace" from the results.

Open the property pane

Click the pencil icon on the web part to open the property pane on the right side.

Set the title (optional)

Enter a descriptive title like "IT Services", "Equipment Catalog", or "Office Supplies".

Select your list

Use the List dropdown picker to select your SharePoint list. The web part will load the list schema automatically.

To use a list from a different site, enter the Site URL first, then select the list.

Choose your layout

Select Grid (tiles) or List (rows) layout. For Grid, choose how many columns per row (2-5).

Configure column visibility

In the "Columns" section, toggle which fields to display on item cards. Title is shown by default.

The column toggles are generated dynamically from your list schema.

Enable/disable features

Toggle Search, Sorting, Category Filter, and Create New button as needed for your use case.

Set pagination

Use the Items Per Page slider (6-50) to control how many items appear before pagination.

Save and publish

Click outside the property pane, then save and publish your page. Your marketplace is now live!

Common Configurations

Copy these ready-to-use configurations for common scenarios:

IT Service Catalog

Searchable IT services with categories

Best for: IT help desk, service portal

Configuration

Title	IT Services
Layout	Grid (3 columns)
Items Per Page	12
Enable Search	Yes
Enable Category Filter	Yes
Show Create Button	No

Office Supplies Catalog

Orderable supplies with create option

Best for: Facilities, office management

Configuration

Title	Office Supplies
Layout	Grid (4 columns)
Items Per Page	24
Enable Search	Yes
Enable Sorting	Yes
Show Create Button	Yes

Equipment Inventory

Asset tracking with list view

Best for: IT asset management, facilities

Configuration

Title	Equipment Inventory
Layout	List
Items Per Page	20
Enable Search	Yes
Enable Sorting	Yes
Enable Category Filter	Yes

Knowledge Base

FAQ or policy directory

Best for: HR, Legal, internal documentation

Configuration

Title	Knowledge Base
Layout	List
Items Per Page	15
Enable Search	Yes
Enable Category Filter	Yes
Show Create Button	No

Best Practices

Add a Choice column for categories

If your list has a Choice column, Marketplace automatically discovers it and creates a filter dropdown. This is the easiest way to enable category filtering.

Use meaningful column names

Column titles are displayed in item cards. Use clear, user-friendly names like "Description" instead of internal names like "Desc1".

Configure columns for your use case

Show only the most important columns on cards. Too many columns create cluttered cards. Users can click items to see full details in SharePoint.

Pagination handles large lists

Marketplace uses SharePoint paging tokens for efficient pagination. It works well with lists containing thousands of items.

User/Person fields show display names

Person columns are automatically expanded to show display names instead of IDs. This requires an extra API call, which may slightly increase load time.

Troubleshooting

Still need help? Contact Bonzai Support

Reference

Technical details for developers and advanced users.

Property Pane Configuration

Property	Type	Required	Description
`title`	Text	No	Web part title displayed above the content
`siteUrl`	Text	No	Site URL for cross-site queries. Leave empty for current site.
`listName`	List Picker	Yes	SharePoint list to display
`layoutType`	Dropdown	No	Grid (tiles) or List (rows). Default: Grid
`itemsPerRow`	Dropdown	No	Columns per row for grid layout (2-5). Default: 3
`itemsPerPage`	Slider (6-50)	No	Items to display per page. Default: 12
`enableSearch`	Toggle	No	Show search box. Default: On
`enableSorting`	Toggle	No	Show sort dropdown. Default: On
`enableCategoryFilter`	Toggle	No	Show category filter dropdowns. Default: On
`showCreateButton`	Toggle	No	Show "Create New" button. Default: On
`displayColumns`	Column Toggles	No	Comma-separated list of column internal names to display

List Requirements

Marketplace works with any SharePoint list (BaseTemplate 100). The only required column is the default Title field, which is used for item names and search.

Minimum Columns

Column	Type	Required	Notes
Title	Single line of text	Yes	Used for item name and search filtering
Created	Date/Time	No	Available for sorting and display
Modified	Date/Time	No	Default sort field when no custom sort is set
Author	Person	No	Expanded to show display name when present

Recommended Columns (Optional)

Column	Type	Purpose
Title	Single line of text	Item name (always displayed)
Description	Multiple lines of text	Item details
Category	Choice	Enables category filtering dropdown
Status	Choice	Item status (Active, Inactive, etc.)
Owner	Person	Responsible person (displays name)

Features Checklist

Dynamic schema discovery (works with any list)
Grid and List layout options
Configurable columns per row (2-5)
Search with debounce (300ms)
Category filtering (auto-discovered from Choice columns)
Sorting by any sortable field (ascending/descending)
Pagination with SharePoint paging tokens
Create New button (opens SharePoint form)
Click-to-view (opens SharePoint display form)
User/Person field expansion (shows display names)
Cross-site data source support
Responsive design
Theme Manager integration

Data Source

Marketplace queries SharePoint lists using the REST API. It uses efficient paging tokens (@odata.nextLink) for pagination, which works well with large lists. The web part caches list schema to reduce API calls.

Migration from Classic Bonzai

The Marketplace web part in Bonzai 2 provides similar functionality to the Classic Bonzai Marketplace, with modernized architecture using React and SPFx. Key improvements include dynamic schema discovery, SharePoint paging tokens for large lists, and automatic User field expansion.