CRUD Grid Element
The CRUD Grid element provides a full-featured data table with inline editing, sorting, filtering, pagination, and CSV import/export capabilities. It is ideal for managing structured data directly within your web application.
Overview
CRUD Grid is ideal for:
- Inventory management
- User directories and contact lists
- Task trackers and to-do lists
- Any structured data that users need to view, add, edit, or delete
Adding a CRUD Grid Element
- Open the Website Builder
- Find CRUD Grid in the Elements panel under Data & Tables
- Drag it onto your page
- Configure columns and settings in the General Tab
Properties
General Tab
| Property | Description |
|---|---|
| Question Text | Label displayed above the grid |
| Columns | Define the columns of your data table |
| Settings | Configure grid behavior (sorting, filtering, etc.) |
Column Configuration
Each column has:
- Header Name - Column header text displayed to users
- Field - Internal field identifier
- Type - Data type:
text,number,date,boolean - Editable - Whether users can edit values in this column
- Required - Whether the field must have a value
Grid Settings
| Setting | Description |
|---|---|
| Enable Sorting | Allow users to sort by clicking column headers |
| Enable Filtering | Show filter inputs above columns |
| Enable Pagination | Split data into pages |
| Page Size | Number of rows per page (when pagination is enabled) |
| Enable CSV Export | Allow users to download data as CSV |
| Enable CSV Import | Allow users to upload data from CSV |
| Row Height | Height of each row in pixels |
| Show Add Button | Display a button to add new rows |
| Show Delete Button | Display a delete button on each row |
| Enable Inline Edit | Allow direct editing by clicking cells |
Grid Style
| Setting | Description |
|---|---|
| Theme | Visual theme (e.g., ag-theme-alpine) |
| Density | Row spacing: comfortable, compact, or spacious |
| Zebra Striping | Alternate row background colors |
| Zebra Color | Color for alternating rows |
| Header Background | Column header background color |
| Header Text Color | Column header text color |
Color Tab
| Property | Description |
|---|---|
| Panel Background | Container background |
| Border Color | Grid border color |
Dimensions Tab
| Property | Description |
|---|---|
| Padding | Inner spacing |
| Border Radius | Corner rounding |
Working with Data
Adding Rows
Click the + Add button (when enabled) to insert a new empty row at the bottom of the grid.
Editing Cells
When inline editing is enabled, click any editable cell to modify its value. Press Enter or click outside to save.
Deleting Rows
Click the delete icon on a row to remove it from the grid.
Sorting
Click a column header to sort ascending. Click again for descending. Click a third time to clear sorting.
Filtering
When filtering is enabled, type in the filter input above a column to filter rows containing that text.
CSV Import / Export
Exporting Data
- Enable CSV Export in grid settings
- A download button appears in the grid toolbar
- Click to download all grid data as a
.csvfile
Importing Data
- Enable CSV Import in grid settings
- An upload button appears in the grid toolbar
- Select a
.csvfile — columns are matched by header names
Database Integration
CRUD Grid data can be saved to the card database:
- Open the Connect Tab
- Enable database connection
- All grid data (rows and columns) is stored and retrieved automatically
Use Cases
Inventory Table
Columns: Product Name, SKU, Quantity, Price
Sorting: Enabled
Filtering: Enabled
Pagination: 25 rows per page
CSV Export: EnabledContact List
Columns: Name, Email, Phone, Department
Inline Edit: Enabled
Add Button: Enabled
Delete Button: EnabledTask Tracker
Columns: Task, Assignee, Status, Due Date
Sorting: Enabled
Filtering: EnabledBest Practices
Keep columns focused - Include only the fields users need to see and edit
Use appropriate types - Set column types correctly so sorting and filtering work as expected
Enable pagination for large data - Grids with many rows perform better with pagination enabled
Mark required fields - Prevent incomplete data entry by marking essential columns as required
Use CSV import for bulk data - Instead of adding rows one by one, prepare data in a spreadsheet and import it
Questions?
If you have any questions, please don't hesitate to contact us. Alternatively, you can submit an issue on this platform.
Useful Links:
Web Elements - https://help.acenji.com/#/./create-web-application/elements/index Dropdown Element - https://help.acenji.com/#/./create-web-application/elements/dropdown/index Tree Navigation Element - https://help.acenji.com/#/./create-web-application/elements/tree-navigation/index