Introducing Matrix Parameters

Matrix parameters key-value pairs parameters separated by semicolon (;) that you can put anywhere on a URI. This is a standard way for specifying parameters in HTTP (in addition to query parameters and path parameters).
For example:

http://repo.jfrog.org/artifactory/libs-releases-local/org/libs-releases-local/org/jfrog/build-info-api/1.3.1/build-info-api-1.3.1.jar;status=DEV;rating=5

Artifactory makes use of matrix parameters for:

Adding properties to artifacts as part of deployment
Controlling artifact resolution using matrix parameters

Dynamically Adding Properties to Artifacts on Deployment

We can add key-value matrix parameters to deploy (PUT) requests and those will be automatically transformed to properties on the deployed artifact.
Since matrix params can be added on any part of the URL, not just at the end, we can add them to the target deployment base URL. At deployment time the artifact path will be added after the matrix parameters and the final deployed artifact will be assigned the defined properties.
We can even use dynamic properties, depending on our deployment framework.

When using Maven, for instance, we can add two parameters to the deployment URL: buildNumer and revision, which Maven will replace at deployment time with dynamic values from the project properties (e.g. by using the Maven build-number plugin).

So, if we define the distribution URL as:

And deploy to the qa-releases repository a jar with the following path:

Upon deployment the URL will be transformed to:

And the deployed build-info-api-1.3.1.jar will have two new properties:

Permissions to attach properties

You need to have the 'Annotate' permission in order to add properties to deployed artifacts.

Controlling Artifact Resolution with Matrix Parameters Queries

Matrix parameters can also be used in artifact resolution, to control how artifacts are found and served.

There is currently support for two types of queries: non-conflicting values & mandatory values.

Non-mandatory Properties

Resolved artifacts may either have no property with the key specified, or have the properly with the key specified and the exact value specified (i.e. the artifact will be resolved if it has a property with a non-conflicting value.
Non-mandatory properties are identified by a simple key=value parameter.

For example:

Current Artifact Property	Matrix Parameter	Resolution Result
color=black	color=black	OK (200)
None or height=50	color=black	OK (200)
color=red	color=black	NOT_FOUND (404)

Mandatory Properties

Resolved artifacts must have a property with the key specified and the exact value specified.
Mandatory properties are identified with a plus sign (+) after the property key: key+=value.

For example:

Current Artifact Property	Matrix Parameter	Resolution Result
color=black	color+=black	OK (200)
None or height=50	color+=black	NOT_FOUND (404)
color=red	color+=black	NOT_FOUND (404)

Multiple properties in queries

Multiple key-value matrix parameters are additive, forming an AND query between each key-value subsection.

Multi-valued Properties Support

All matrix parameters can support multiple values by separating values with a comma (,). For example: