Create an attribute

You can add attributes to provide more information about XML elements and configure component relationships in the system.

You must have Administrator permissions to manage attributes.

Tips and tricks

Understanding attributes: To learn more about what an attribute is and why you use them, read Attribute FAQs.
Profiled: If you only want to update an attribute so it can be used for profiling, follow the steps in: Allow an attribute to be used for profiling.
Identifier: If you only want to create an attribute to tag content with the schema standard you are using, follow the steps in: Create an attribute to be a component identifier.
Language: If you only want to create an attribute to tag content with the language you're using, follow the steps in: Create a language identifier attribute.
Protected: If you only want to update an attribute to prevent an author from updating or deleting it in the Oxygen editor, follow the steps in: Work with protected attributes.

Rules for component and language identifiers:

There must be only one attribute that is the DITA component identifier.
- Inspire provides one for DITA (<id>).
- If you want to create your own component identifier attribute for DITA, you must update the default attribute to clear the Identifier option.
There must be only one attribute that is the DocBook component identifier.
- Inspire provides one for DocBook (<xml:id>).
- If you want to create your own component identifier attribute for DocBook, you must update the default attribute to clear the Identifier option.
There must be only one attribute that is the DITA language identifier.
- Inspire provides one for DITA (<xml:lang>).
- If you want to create your own language identifier attribute for DITA, you must update the default attribute to clear the Language option.
It is not possible for an attribute to be both a language identifier and a component identifier at the same time.

To create an attribute:

From the Administration menu, select Advanced Settings, and then Attribute Management.
On the Attribute Management tab, click Create.
Result: The Create new attribute screen opens.
Enter a unique Name using 100 characters or less.
Important:
- This is a system name, so you cannot use spaces or special characters
- The name must be different from any system-created names, like <id>, <xml:id>, or <xml:lang>
Optionally, you can create a similar Display Name that's more user-friendly.
Notes:
- Use 100 characters or less
- This is the name an author will see when selecting an attribute in the Oxygen editor
- If you don't enter a Display Name, the system Name is shown instead
In Schema Standard, select the schema version that must be used to validate the attribute. For example, DITA_1.3.
Optionally, to specify that this attribute can be used to identify conditional text, select Profiled.
For more information, refer to: Why would I want an attribute to be profiled?
If you want the attribute to be used to tag content with the schema standard you are using, select Identifier.
Important:
- It is not possible for an attribute to be both a component identifier and a language identifier.
- If you select the Identifier option, there must be no other attribute that already has this property.
- If you select the Identifier option, you cannot also select the Language option.
- For more information, refer to: Why do I need an attribute that is a component identifier?
If you want the attribute to hold a language code that is used to tag content, select Language.
Important:
- It is not possible for an attribute to be both a language identifier and a component identifier.
- If you select the Language option, there must be no other attribute that already has this property.
- If you select the Language option, you cannot also select the Identifier option.
- For more information, refer to: Why do I need an attribute that is a language identifier?
If you want to prevent an author from updating or deleting this attribute in the Oxygen editor, select Protected.
For more information, refer to: Why would I want to protect an attribute?
To create the attribute, click Create.
Results:
- Administrators can see the new attribute on the Attribute Management tab in the list of attributes.
- Administrators can select the attribute from the lists on the XML Link Type Configuration screens.
- Users can select this attribute in the Oxygen editor in the Attributes pane on the right side.
- If you selected the Profiled option, then users can select the attribute from the lists on the Profiling Attributes screen.
- If you selected the Protected option:
  - In the Oxygen editor, to delete or update protected attributes, users must have one of the following permissions:
    - Permissions to the can_modify_protected_attributes property
    - Administrator
  - This protection is enforced in the Oxygen editor in the following places:
    - Author mode
    - Edit XML Source mode
    - Reviews
    - Resolving reviews