Order - How to Create custom fields in Spacefill ?
Custom fields allow you to enrich your data model in Spacefill by adding your own attributes to orders or order items. You can use them to store additional information such as reference numbers, delivery notes, or specific flags.
📍 Where to Find Custom Fields
To create or manage your custom fields:
-
Go to Settings in the left-hand menu.
-
Select Custom Fields.
-
Click New Custom Field.
🧩 Creating a Custom Field
When creating a new custom field, you’ll need to define several properties:
| Field | Description |
|---|---|
| Custom Field Name | The display name of your custom field as it will appear in the Spacefill app. |
| Custom Field ID | The API name of the field. This identifier is used when integrating with external systems or using the API. |
| Custom Field Type | Defines the format of the data your field will hold. Possible types include: |
| - Text: for short text values (e.g. “Urgent”) | |
| - Number: for numeric values (e.g. “100”) | |
| - Date: for dates (e.g. “2025-10-08”) | |
| - Boolean: for yes/no values |
📦 Choosing the Resource Level
You’ll need to specify where your custom field should be applied:
-
Order: Custom fields created at the Order level apply to the entire order (header-level data).
Example: "Customer Reference" or "Delivery Priority". -
Order Item: Custom fields created at the Order Item level apply to each line within an order.
Example: "Expiration Date".
✅ Example
Let’s say you want to track whether an order requires a quality check.
| Field | Value |
|---|---|
| Custom Field Name | Quality Check Required |
| Custom Field ID | quality_check_required |
| Custom Field Type | Boolean |
| Resource | Order |
This will create a checkbox at the order level, allowing you to flag orders that need special inspection.