Manage Property Sets

Create and manage property sets that define structured metadata for artifacts. In a Federation, property set definitions aren't synchronized across members, but individual artifact properties are synchronized.

Who can perform this task: Platform Administrators

Prerequisites:

• Admin access to the JFrog Platform

Using the Platform UI

• Create a Property Set
• Edit a Property Set
• Delete a Property Set
• Assign a Property Set to a Repository

Create a Property Set

Define a new property set and the individual properties it contains.

To create a new property set:

1. In the Administration module, navigate to Artifactory Settings > Property Sets.
2. Click New Property Set.
3. Enter a unique Name for the property set.
4. Click Add Property to define properties within the set.

5. Add as many properties as needed.
6. Click Save.

Edit a Property Set

Modify an existing property set's properties.

To edit a property set:

1. Click the property set name to open it.
2. Modify property definitions, add new properties, or remove existing ones.
3. Click Save.

Delete a Property Set

Remove a property set that's no longer needed.

To delete a property set:

1. Select the property set.
2. Click Delete.

Assign a Property Set to a Repository

Apply a property set to a specific repository so its properties are available for artifacts in that repository.

To assign a property set to a repository:

1. In the Administration module, click Repositories.
2. Select the repository to configure.
3. In the Advanced tab, locate the Property Sets field.
4. Select the property sets to assign.
5. Click Save.

Using the REST API

Retrieve property sets from the global configuration:

GET /artifactory/api/system/configuration

Property sets are defined in the propertySets section of the returned YAML.

Manage artifact-level properties using the Item Properties REST APIs (replace {repoKey} and {itemPath} with the target repository and item path):

PUT /artifactory/api/storage/{repoKey}/{itemPath}?properties=key=value

For example:

PUT /artifactory/api/storage/libs-release-local/com/myapp/1.0/app.jar?properties=release.stage=production

Federation Considerations

• Property set definitions are not synchronized: The propertySets configuration is listed in the Synchronized Metadata Reference as a setting that isn't synchronized among Federation members. You must create the same property set definitions on each member independently.
• Artifact properties are synchronized: While property set definitions are local, the actual properties assigned to individual artifacts and folders are synchronized across Federation members. When you set a property on an artifact, that property value propagates to all members.
• Assignment consistency: For a consistent user experience, assign the same property sets to the Federated repository on each member. If a property set exists on one member but not another, users on the member without the definition can still see synchronized property values but can't use the UI to manage them through the property set interface.
• Predefined values: If you use predefined values (Single Select or Multi Select), ensure the same values are defined on all members. Otherwise, synchronized property values may not match the predefined list on some members.

Frequently Asked Questions

This section provides answers to frequently asked questions.

Related Topics

• Synchronized Metadata Reference
• Synchronization and Conflict Resolution
• Edit a Federated Repository