Custom data
Custom data fields for your items and rentals
Custom data allows you to add custom field definitions to your items and rentals, enabling you to capture additional information specific to your business needs. This feature is particularly useful for tracking specialized attributes, internal notes, or business-specific data that isn’t covered by Supercycle’s standard fields.
Setting up custom data
Access custom data settings
Navigate to custom data
In Shopify Admin, head to Supercycle > Settings > Custom data.
Create custom field definitions
Choose data type
Select whether you want to add custom fields to Items or Rentals.
Add new definition
Click Add definition to create a new custom field.
Configure field details
Set up your custom field:
- Name: Display name for the field (e.g., “Serial Number”, “Condition Notes”)
- Key: Auto-generated identifier based on the name (can be manually edited)
- Type: Currently supports “Single line text field” only
Save definition
Click Save to create the custom field definition.
Managing custom field definitions
Edit existing definitions
Edit existing definitions
Click on any custom field definition name to edit its settings. You can update the name and key, but the type cannot be changed after creation.
View usage statistics
View usage statistics
The custom data table shows how many items or rentals are using each field definition, helping you track adoption and identify unused fields.
Delete definitions
Delete definitions
Use the Delete button on individual field definition pages to remove unused custom fields. Be careful as this action cannot be undone.
Best practices
Field naming
Field naming
Use clear, descriptive names for your custom fields that will be easily understood by your team (e.g., “Warranty Expiration”, “Purchase Order Number”).
Key consistency
Key consistency
While keys are auto-generated, you can customize them for API consistency. Use lowercase letters, numbers, and underscores only.
Related documentation
- Items management - Learn how custom fields integrate with item management
- API Reference - Technical details for accessing custom data via API