Skip to main content
Custom fields let you add custom field definitions to your items, cycles, and consignors, so you can capture additional information specific to your business needs. This is useful for tracking specialized attributes, internal notes, or business-specific data that isn’t covered by Supercycle’s standard fields. Supercycle custom fields are available on:
  • Items
  • Cycles
  • Consignors
For other Shopify resources such as products, variants, orders, and customers, use Shopify metafields to capture the same kind of structured custom data. Shopify metafields and Supercycle custom fields can coexist on the same resource. For read-only fields whose values are computed from a formula, see Calculated fields.

​
Setting up custom fields

​
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, Cycles, or Consignors.
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 fields support the following 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
IntegerWhole number input (positive or negative)
ColorHex color value (e.g. #1a2b3c)
URLLink to an external resource (must start with http:// or https://)
JSONArbitrary JSON-formatted value for structured data
Customer referenceLink to a customer record
Cycle referenceLink to a cycle record
Item referenceLink to an item 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 cycles 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.