Skip to main content
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

1

Navigate to custom data

In Shopify Admin, head to Supercycle > Settings > Custom data.

​
Create custom field definitions

1

Choose data type

Select whether you want to add custom fields to Items or Rentals.
2

Add new definition

Click Add definition to create a new custom field.
3

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: Select from the available field types (see below)
4

Save definition

Click Save to create the custom field definition.

​
Field types

Custom data supports the following field types:
TypeDescription
Single line text fieldShort text input for simple values like serial numbers or codes
Multi line text fieldLonger text input for notes or descriptions
BooleanTrue/false checkbox for yes/no values
DateDate picker for dates without time
Date and timeDate and time picker for timestamps
MoneyCurrency value input
Customer referenceLink to a customer record
Rental referenceLink to a rental record
Return referenceLink to a return order record
The field type cannot be changed after creation. Choose the appropriate type when creating your custom field definition.

​
Managing custom field 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.
The custom data table shows how many items or rentals are using each field definition, helping you track adoption and identify unused fields.
Use the Delete button on individual field definition pages to remove unused custom fields. Be careful as this action cannot be undone.

​
Best practices

Use clear, descriptive names for your custom fields that will be easily understood by your team (e.g., “Warranty Expiration”, “Purchase Order Number”).
While keys are auto-generated, you can customize them for API consistency. Use lowercase letters, numbers, and underscores only.