Mastering Custom Fields in Shelf: Complete Guide to Asset Information Customization

Custom fields serve as foundational elements in Shelf, enabling organizations to customize their asset management systems to match specific workflow requirements. Whether managing IT equipment, vehicles, laboratory instruments, or other assets, custom fields allow teams to capture essential organizational information.

Understanding Custom Fields

Custom fields in Shelf provide intelligent, contextual additions that:

• Enforce data quality through required field validation
• Streamline workflows with category-specific field mapping
• Maintain consistency across teams and processes
• Provide guidance through contextual help text
• Support complex filtering for advanced asset searches
• Enable rich reporting through structured data export

Available Field Types

Single-line Text

Ideal for concise, searchable, and comparable information.

Best for:

• Serial numbers and model identifiers
• Supplier codes and part numbers
• Location codes and asset tags
• Simple classification labels

Example: Asset Tag: "NYC-LAB-001"

Multi-line Text

Supports rich formatting and detailed information entry.

Best for:

• Maintenance instructions and procedures
• Asset history and incident reports
• Technical specifications and configurations
• Usage guidelines and safety notes

Date

Intuitive calendar picker with consistent date formatting.

Best for:

• Purchase and warranty dates
• Maintenance schedules and calibration due dates
• Lease expiration and renewal dates
• Compliance deadlines and audit dates

Example: Next Calibration Date: 2024-06-15

Option

Dropdown menu with predefined choices ensuring data consistency.

Best for:

• Status indicators (Excellent, Good, Fair, Poor)
• Department or team assignments
• Compliance levels and certifications
• Equipment conditions and ratings

Example: Condition dropdown with options: New, Good, Fair, Needs Repair, Retired

An Option field needs at least one option before you can save it. Type each choice into the builder and press enter. Spaces at the start and end of an option are trimmed, and a blank or repeated option is not added.

Managing an Option field's choices

Open the field under Settings → Custom fields and click it to edit. Each option that is in use shows Used on N assets, so you can see what a change will touch before you make it. Nothing changes on any asset until you save the field.

• Reorder. Drag an option by its handle, or focus it and press Alt+Up / Alt+Down. The order you save is the order everyone sees in the asset form, the filters and the Shelf Companion app.
• Sort A-Z. One click puts the options in alphabetical order. Undo sort puts them back until you make another change.
• Rename. Click an option to change its spelling. When you save, every asset that holds the old spelling moves to the new one.
• Merge duplicates. Options that differ only in capital letters or spaces, such as Sony and sony , are flagged with Merge duplicates. Merging keeps the first spelling, and the assets holding the others move to it when you save.
• Remove. Removing an option that is in use asks first and names how many assets hold it. Those assets keep their current value, but it is no longer one of the choices; rename the option instead if you want them updated.

A rename or merge does not write a note on each asset's activity. A saved filter or a link that names the old spelling stops matching after the rename, so update it to the new one.

When a dropdown has more than eight options, the value picker in the advanced index filters and the picker in the Shelf Companion app get a search box, so a long list stays quick to use.

Boolean

Simple yes/no toggle for binary decisions and status tracking.

Best for:

• Warranty status (covered/expired)
• Compliance flags (compliant/non-compliant)
• Feature availability (available/unavailable)
• Safety certifications (certified/not certified)

Example: Under Warranty: Yes/No toggle

Amount (Currency)

Specifically designed for monetary values with automatic currency formatting.

Key Features:

• Automatically formats with your organization's currency symbol
• Accepts zero and positive values in the asset form (perfect for costs, prices, budgets)
• Exports with proper currency formatting ($1,234.56)
• Advanced filtering with currency-aware comparisons

Best for:

• Purchase prices and current valuations
• Maintenance costs and budget allocations
• Insurance values and replacement costs
• Lease payments and rental fees

Example: Purchase Price: $2,499.99 (displays with currency symbol)

Number

Flexible numeric field handling any numeric data including negatives.

Key Features:

• Accepts positive and negative values, and zero
• Precise decimal handling for measurements
• Advanced filtering with flexible range queries
• Plain number export (no formatting symbols)

Best for:

• Temperature ratings and environmental specs
• Measurement values and tolerances
• Quantity counts and inventory levels
• Performance metrics and scores
• Coordinates and technical measurements

Zero and empty in number fields

For Amount and Number fields, 0 is a real answer and an empty field is not:

• A required Amount or Number field accepts 0. Only an empty field is refused.
• An optional field you leave empty stays empty. Shelf does not store it as 0.

Advanced Custom Field Features

Smart Filtering

• Amount fields: Filter by currency ranges with validation
• Number fields: Support complex ranges including negative values
• Text fields: Full-text search and pattern matching
• Date fields: Calendar-based range selection
• Boolean fields: Quick yes/no filtering

Import and Export Intelligence

• CSV Import: declare the field type in the header (e.g. cf:Purchase Date,type:date); Shelf auto-creates the custom field if it does not exist, using the type from the header. For option fields, the set of allowed values is collected automatically from the data in that column.
• Export Formatting: Currency fields export with symbols, numbers export plain
• Template Generation: Download pre-configured CSV templates
• Data Validation: Import validation prevents data corruption

Category-Specific Mapping

Create tailored forms for different asset types:

• IT Equipment: Serial numbers, warranty dates, software licenses
• Vehicles: Mileage, insurance expiration, maintenance schedules
• Lab Equipment: Calibration dates, accuracy specs, compliance certificates
• Furniture: Dimensions, materials, purchase information

Setting Up Custom Fields

1. Navigate to Settings > Custom Fields
2. Design your field:
   • Choose a clear, descriptive name
   • Select the most appropriate field type
   • Write helpful placeholder text
   • Add guidance in the help text field
3. Configure requirements:
   • Set as required for critical information
   • Map to specific asset categories when needed
   • Set active status for immediate use
4. Test and refine:
   • Create a test asset to verify field behavior
   • Adjust settings based on user feedback
   • Monitor data quality and consistency

Best Practices for Custom Fields

Field Design Principles

• Start essential, expand gradually: Begin with must-have fields and add more as workflows mature
• Use consistent naming: Establish clear conventions (e.g., "Purchase Date" vs "Date Purchased")
• Choose types thoughtfully: Amount vs Number makes a big difference in usage
• Provide clear help text: Guide users on format and expectations

Data Quality Management

• Make critical fields required: Ensure completeness for essential information
• Use Option fields for standardization: Prevent inconsistent entries
• Regular review cycles: Periodically assess which fields are actually used
• Category mapping strategy: Balance specificity with simplicity

Performance Optimization

• Limit initial visible fields: Too many fields overwhelm users
• Strategic required fields: Only require truly essential information
• Meaningful field grouping: Use categories to organize related fields
• Regular cleanup: Deactivate unused fields rather than deleting

Working with Custom Fields Data

Advanced Filtering

Custom fields unlock powerful search capabilities:

• Combine multiple field filters for precise asset queries
• Use amount fields for budget-based filtering
• Leverage number fields for specification-based searches
• Create saved filter combinations for repeated use

Reporting and Export

• Export custom field data with proper formatting
• Amount fields automatically include currency symbols
• Number fields maintain precision for technical data
• Date fields export in standard formats for analysis

Filling a Field on Many Assets

Select assets on the asset index and choose Actions → Set custom field to give them all one value for one field. By default only assets with no value are filled; Replace their value overwrites the rest. See Setting a Custom Field on Many Assets.

Data Import Strategies

• Use provided CSV templates to ensure proper formatting
• Amount fields: Enter numbers without currency symbols (1234.56)
• Number fields: Include negative values when needed (-40)
• Test imports with small batches before full deployment

Integration with Workflows

Custom fields integrate seamlessly with Shelf's core features:

• QR Code Labels: Include custom field data on printed labels
• Mobile Scanning: View and edit custom fields via mobile devices
• Booking System: Custom fields help identify the right assets for bookings
• Maintenance Tracking: Date fields drive proactive maintenance scheduling

Custom fields transform Shelf from a generic tool into your organization's perfect asset management solution. The key is thoughtful implementation that grows with your needs while maintaining data quality and user experience.