Skip to main content
First Key Decision
The first and most fundamental decision you make when creating a new snippet in Crust AI is selecting its Snippet Type. This choice determines the core structure and purpose of the mini-application, specifically whether it focuses on displaying the details of a single record or presenting a list of multiple records.

Single Item vs. Multiple Items Snippets

Crust AI offers two distinct snippet types to cover the most common data visualization and sharing needs: The List View provides a high-level overview, and the Detail View provides the granular information for each item in that list.

Views and Navigation

Every snippet has at least a Detail View. A Single Item snippet only has a Detail View because its purpose is to show the full information for one predetermined record. A Multiple Items snippet has both a List View and a Detail View. The List View is the default view when the snippet is opened. From the List View, users can click on any individual item (record) in the list to automatically navigate to that record’s Detail View. Multi Single Navigation Gi

Selecting Data for Each Type

The way you define which specific record(s) are displayed differs based on the snippet type:
In Step 2 of the builder, you’ll see a table preview of your data. You select the specific record you want this snippet to display by clicking the radio button next to its row. This selected record defines the core data for this specific Single Item snippet URL.Quick Start Single Snippet Record Selection GiThe Shareable URL for this snippet will be built to directly reference the unique ID of the record you selected. Sharing this specific URL will always open the snippet showing the details of that particular record.

Important
Read this to avoid confusion and manage your snippets effectively
Filters and Sorting Any changes you make to the Filter or Sort settings in Step 2 of the builder will immediately affect ALL existing and future Shareable URLs for that specific snippet. If you update a filter to exclude certain records, those records will instantly disappear from any live view of that snippet’s URL. If you need two different lists of data from the same table (e.g., one showing only `Active` campaigns and another showing only `Completed` campaigns), you should create two separate Multiple Items snippets, each with its own filter configuration. Permissions (User-based) Changing the Permission setting (specifically enabling or changing the permission field) in Step 2 does NOT require you to create a new snippet URL to show different data. The power of user-based permission is that the same base URL (e.g., `https://app.trycrust.ai/<your_snippet_id>/list`) can present different data to different users because the permission value is passed dynamically via the URL parameter (`?p=<permission_value>`). This allows you to create one snippet configured for user-based permission and use it to share personalized data views with many different clients. Understanding this distinction is vital for correctly managing your shared data and creating efficient workflows.