A new custom attribute defines what objects of one or more object types record, suggesting a matching standard attribute to reuse instead when one exists.
For what attributes are and when to reuse a standard one, see Types of attributes.
Prerequisites
- Only administrators can create attributes here.
- Reuse standard attributes where possible. They keep filtering and reporting consistent across applications.
- This adds attributes only to object types that your instance owns, such as types created through custom applications. Object types from a marketplace application can’t receive custom attributes.
Your work stays in the browser tab until you finish; nothing is stored on the server before that. Leaving the page asks Discard this wizard?, while reloading or closing the tab triggers the browser’s own warning instead. Either one discards your work.
Open the New attributes page
In the top navigation, click the arrow next to Create and select New attribute. Here, define the new attribute and add it to the selected object types.
To define an attribute for just one object type, add it inline in the custom attributes table on that type’s Attributes step instead. See New object type.
Define the attribute type
On the What it is step:
- Name the new attribute type. It’s required.
- Select the Value type. The following are available:
| Value type | Description |
|---|---|
| Plain text | Short single-line text |
| Rich text | Formatted paragraphs |
| Number | Numeric value |
| Date | Calendar date |
| Yes / no | Checkbox flag |
| Dropdown | Pick from fixed options |
| Link | URL to an external page |
| Code | Monospaced snippet |
- Click Continue.
When a standard attribute with a similar name already exists, you can reuse it instead. Click Use ‹name› instead to add the existing attribute to your object types (moving on to Behavior), or Keep creating new to dismiss the suggestion and define your own.
Define behavior
The Behavior step sets how the attribute behaves.
| Option | What it does | Default |
|---|---|---|
| Required | Objects can’t be completed without a value. | Off |
| Searchable | The value appears in full-text search and filters. | On |
| Use in AI summaries | The value is included when AI describes the object. | Off |
| Dropdown options | Available only for Dropdown. Click Add option for each value and enter its label; drag them, or use Move up and Move down, to set their order. At least one is required, and blank or case-insensitive duplicate options are dropped when the attribute is created. | |
| Language | Available only for Code. Select the language of the code. |
Add to object types
- Select the Application.
- Select the object types that receive the attribute. At least one is required.
The attribute is placed into each object type’s page layout automatically. Once you select one object type, the rest are limited to the same configuration package.
Review & create
The Summary shows the Name, Value type, and Behavior options you chose. For a dropdown, it also shows how many options are left after blanks and duplicates are dropped. Added to lists the object types.
The What will be created card describes the result:
- A new attribute: “Attribute ‹name› (‹value type›)” and “Added to ‹object types›”.
- A reused attribute: “The existing attribute ‹name›, reused” and “Added to ‹object types›”.
Click Create attribute.
Installation status
An attribute added in the custom attributes table on an object type’s Attributes step is installed with the object type.
| Status | What you see | What you can do |
|---|---|---|
| Installing | ”Creating attribute ‹name›… This can take a few minutes. Keep this page open until it finishes.” | Wait. |
| Installed | ”Attribute ‹name› was created.” and “You can open it now or create another one.” For a reused attribute, “Already assigned to ‹object types›” names the types that had it already. | Click Finish to close the page, or Create another attribute. |
| Installed with warnings | Installed with warnings with the list of warnings. | Click Finish or Create another attribute. |
| Failed | ”The attribute could not be installed.” with the reported issues and “See Settings › Packages for details.” | Click Run the installation again, Open Settings › Packages, or Start over. |
| Installed, but not found | ”The attribute could not be installed.” with “The package was installed, but the new item could not be found in it.” and “See Settings › Packages for details.” | Click Open Settings › Packages or Start over. |
| Taking too long | ”Installation of ‹name› is taking longer than expected. Check Settings › Packages.” | Click Open Settings › Packages or Start over. |
| Status unreachable | ”The installation status of ‹name› cannot be reached right now. Check your connection and try again.” | Click Check again, Open Settings › Packages, or Start over. |
When the installation fails, choose how to continue:
- Click Run the installation again when the failure was temporary. Dawiso validates and installs the same draft version again, and the screen shows the progress. If the installation can’t be started, the screen shows “The installation couldn’t be started again. Reload the page and try again.”
- Click Start over, define the attribute again with the corrected input, and create it. Dawiso replaces the failed draft version and installs the new one.
A failed installation doesn’t block the package. A draft whose installation is still running, or a draft that was created in Settings > Packages and never installed, still blocks the package. See Troubleshooting.
Troubleshooting
Name and value type
| Message | What to do |
|---|---|
| ”Name is required.” | Enter a name on the What it is step. |
| ”Choose a value type.” | Select a value type on the What it is step. |
Behavior options
| Message | What to do |
|---|---|
| ”Add at least one option” | Add a dropdown option on the Behavior step. |
| ”Add this attribute to at least one object type.” | Select an object type under Add to object types. |
| ”This attribute can only be added to object types owned by this instance.” | Choose object types from an application that your instance owns. |
| ”The selected object types belong to different configuration packages. Choose object types from a single package.” | Choose object types from one application’s package. |
| ”This attribute is already assigned to the selected object type.” | Every selected object type has the attribute already. Choose other object types. |
Naming and reuse
| Message | What to do |
|---|---|
| ”An attribute with this name already exists. Choose a different name.” | Rename the attribute, or reuse the existing one. |
| ”An attribute with this name already exists in this application. Choose a different name.” | In the application editor, rename the custom attribute. |
| ”This attribute is shared with another object type, but its definition differs there. Reload the application and try again.” | In the application editor, reload the application and make the change again. |
Creating the attribute
| Message | What to do |
|---|---|
| ”The text ‹translation key› has no translation. Choose another value, or add the translation in Settings › Translations.” | Choose another value, or add the translation in Settings > Translations. This is reported after you click Create attribute, and nothing is created. |
| ”A draft version of this configuration package is still being installed or is waiting in Settings › Packages. Wait for the installation to finish, or install or discard the draft there.” | Wait for the installation to finish. Otherwise install or discard the draft in Settings > Packages > Resources, then create the attribute again. |