Custom fields allow you to capture data that is important to your business but not a part of Aha! by default. You can add any number of fields to suit your needs, and every field you add can be reported on through the various Aha! reporting tools.
To avoid cluttering the UI with unused fields, we suggest that you add only what is essential. But, ultimately, it is all up to you. Aha! users create custom fields for product components, expected revenue, priority, hardware supported, committed customer dates, or any other information that will influence their work.
Adding a custom field is a three-step process which requires owner user permissions for the workspace where you want to use the custom field, and customization administrator permissions to your Aha! account.
Click any of the following links to skip ahead:
- Add a custom field
- Place the custom field in a custom field layout
- Apply your custom layout to your workspace
- Import data to custom fields
- Search for custom field values
- Expand beyond custom fields with custom tables
- Custom table relationships
Add a custom field
- Navigate to Settings > Account > Custom fields.
- Click on the tab where you want to add the field, and then click Add custom field.
- Select the type of field you want to add, and then click Next. If you are an Enterprise + customer, this list will include custom worksheet fields.
- Note: Aha! record relationships are custom field types that allow you to associate records with other record types like workspaces, competitors, and personas. These are a tag type field that allows multiple selections. When configuring this custom field, you can use Filter field values to specify whether the selectable values should span the entire account or be isolated to a specific line or workspace. Further, users will only see values that they have permission to see.
- Note: When you select an Editable choice list or Tags field for your ideas portal, users can choose existing values but not create new ones.
- Enter the field details and, if needed, enter an API key in the Key field. Depending on the custom field type you select, this step is also where you can bulk edit or assign colors to predefined field choices.
- Specify the custom layout where your custom field should appear by choosing Use in layouts and selecting the custom field layout in use by your product or workspace.
Note: If your product does not yet have any custom layouts for this record type, then choose Use in products (or Use in workspaces). This will automatically create a new custom layout for your new field and assign that layout to the product or workspace that you have selected.
- Click Create.
Place the custom field in a custom field layout
If you added your custom field to a custom layout while creating it, you can select where on the layout you want to place your field by navigating to Settings > Account > Custom layouts and editing the layout in question.
What is a layout? It’s where you determine where you want custom fields to display on the page for a record type. By default, your custom field will be added as the last field of the top-most section of your layout (unless it is a master-detail custom field, which will be added to the middle section of the layout).
For the purposes of this article, though, let's say that you would like to create a new custom layout for your custom field.
You can create different layouts for the creation of the record and the record itself. For example, you may only want to require a few fields for a user to create a feature/activity, but once it has been created (and as it progresses towards completion) you might want a wealth a fields. These two types of layout are called the Create layout and the Detail custom field layout.
Layouts are organized by data object, which can be selected at the top of Settings > Account > Custom layouts. After you have selected the data object for which you want to manage a layout, you will have options to:
- Add a new custom layout.
- Clone an existing custom layout. Hover to the right of the layout you want to copy in the Actions column, and then click Clone. A new duplicate layout will be created with the same name prepended with "[Copy]" for you to edit and assign to products.
- Modify an existing custom layout. Hover to the right of the layout you want to edit in the Actions column, and then click Edit. Use the tabs to select whether you would like to modify the Create layout or the Detail custom field layout, then drag and drop each field from the Available Fields column to the Visible fields column in the desired order. You can also use the search field to quickly find the custom fields you need from the list. To remove a field, simply move it back over to Available Fields and it will no longer display that layout.
Tip: To mandate fields on create record forms, you can set visible fields to Required. For more information on setting up custom layouts, see our support article on creating custom layouts.
Apply your custom layout to your workspace
Now that you have your layout defined, it is time to determine which workspaces it will apply to. Go to Settings > Product (or workspace) > Configure. Scroll to the custom layouts section, and then select Use layouts inherited from [line name] or Customize layouts.
Search for custom field values
You can use Aha! search to search for custom field values for most types of custom fields. The following custom field types are searchable:
- Predefined choice list
- Editable choice list
- Predefined tags
Import data to custom fields
After you create a custom field, you can populate it using the Import from CSV tool. Each custom field requires its own column. If you are using a custom field with a predefined list, make sure the data you are importing matches the options in the list.
Expand beyond custom fields with custom tables
Custom tables are available to Enterprise+ customers. A custom table is a collection of records organized in a table with data defined by custom fields. With custom tables, you can capture key information and link it directly to your existing data in Aha! — expanding your use of custom fields exponentially.
Custom table relationships
These options are exclusively available to Enterprise+ customers who use custom tables.
- Many to many relationship: Allows linking multiple records from a custom table to a standard record or another custom table.
- Master-detail relationship: Create and edit custom table entries inline within a standard table or another custom table.