Josys allows you to extend your data models by creating custom fields. This gives you the flexibility to track organization-specific details for both your User Profiles (e.g., employee details, alternate contact info) and Devices (e.g., storage location, secondary usage flags).
Accessing Custom Fields
To manage your custom fields:
Step 1: Log in to the Josys portal using your Josys credentials.
Step 2: In the left navigation menu, go to Settings scroll down to the Company section and click on Custom Fields.
Step 3: You will see two primary tabs at the top of the workspace as shown in the interface:
User Profiles: Manage custom data fields associated with your employees and members.
Devices: Manage custom data fields associated with your hardware inventory.
Adding a New Custom Field
Step 1: Select either the User Profiles or Devices tab depending on where you want the new field to appear.
Step 2: Click the + Add button located in the top right corner.
Step 3: In the Add new Custom Field modal configuration window (as seen in image_a08bde.png), fill out the following details:
Custom Field Name*: Enter a clear name for your field.
Type*: Select the input format from the dropdown menu (e.g., Text, Dropdown, Date).
Number of Rows* (Available for text types): Select Single (up to 300 characters) or Multiple (up to 33,000 characters).
Hint: Input descriptive helper text to guide administrators when they populate this field.
Required (Toggle): Toggle this switch on if this field must be filled out before saving a device or profile record.
Step 4 Click the Add button to save and deploy the new field.
Editing an Existing Custom Field
Step 1: Find the custom field you wish to modify from the list.
Step 2: Click the Action Menu (Three Dots icon ⋮) located on the far right side of that field's row (visible in image_a1747e.png).
Step 3: Select Edit from the dropdown options.
Step 4: Update the necessary configuration fields within the modal window.
Step 5: Click Save to apply your changes.
Deleting a Custom Field
⚠️ Important Note: Deleting a custom field is a permanent action. Doing so will remove this data field and any associated stored information from all historical User Profiles or Device entries.
Step 1: Find the custom field you want to remove.
Step 2: Click the Action Menu (Three Dots icon ⋮) on the far right of the row (visible in image_a1747e.png).
Step 3: Select Delete from the dropdown options.
Step 4: A confirmation dialog box will pop up warning you about data loss. Confirm the action by clicking Delete.
Customizing Row Order (Device only)
For Devices, you can change the order in which custom fields are listed. The display order you set here will directly reflect how these fields appear when viewing individual device detail pages.
Step 1: Open Devices tab
Step 2: Click the Customize Rows button located in the top right corner of the workspace, next to the + Add button
Step 3: In the settings view or overlay that appears, use drag-and-drop to rearrange the fields vertically into your preferred order.
Step 4: Save your adjustments. The new arrangement will instantly update across your device registry layout.