ARTIFACTORY: How to fix the issue of NuGet packages Search on virtual repository to return expected packages

Products
Frog_Artifactory
Content Type
Use_Case
AuthorFullName__c
Marwa Sharif
articleNumber
000006517
FirstPublishedDate
2025-07-08T13:34:03Z
lastModifiedDate
2026-10-12

ARTIFACTORY: How to fix the issue of NuGet packages Search on virtual repository to return expected packages

 
Artifactory version: 7.x and above
Overview
This article explains why NuGet package search results may differ between a Remote repository and a Virtual repository in Artifactory, and provides the system properties needed to align search behavior with the upstream NuGet registry.


Background - Remote vs Virtual Repository Behavior
Understanding why results differ starts with understanding how each repository type works:
Remote Repository
 A Remote repository acts as a direct proxy for an external source such as nuget.org. Because it proxies requests directly to the upstream registry, search results should match what you would see when querying the registry directly.
Virtual Repository
 A Virtual repository aggregates multiple repositories - both local and remote - behind a single endpoint. It provides a unified access point for all included repositories and may manipulate or merge responses based on its configuration. As a result:
  • Search results may include artifacts from both local and remote repositories
  • The order of results is not guaranteed to match the order returned by a Remote repository or the upstream registry
  • This behavior is by design and is expected when local repositories are part of the Virtual repository
Important:

 The order of NuGet search results in a Virtual repository (V2 or V3) is not guaranteed to be the same as in a Remote repository (V2 or V3). This is expected behavior when the Virtual repository includes local repositories in addition to remote ones.


Root Cause
Two separate behavioral gaps contribute to the difference in search results:
Gap 1: NuGet Package Handler Logic
 Some NuGet packages contain a projectUrl field that Artifactory misinterprets during package processing. This causes incorrect metadata handling and affects search results returned from both Remote and Virtual repositories.
Gap 2: Search Result Relevancy Sorting
 NuGet search returns up to a maximum of 1,000 results per query. Without relevancy sorting, these results are not guaranteed to be ordered by relevance - meaning the most relevant packages may not appear at the top of the results, particularly in Virtual repositories.


Resolution - Apply System Properties
To align NuGet search behavior as closely as possible with the upstream registry, add the following two properties to your Artifactory system properties file.


Step 1 - Open the System Properties File
$JFROG_HOME/artifactory/var/etc/artifactory/artifactory.system.properties
Installation Type
Default $JFROG_HOME Path
Linux (RPM/DEB/TAR)
/opt/jfrog/artifactory
Docker
/var/opt/jfrog/artifactory (mapped volume)
Windows
C:\JFrog\Artifactory
Kubernetes/Helm
Mounted via ConfigMap or persistent volume


Step 2 - Add the Following Properties
Note:

The properties below were introduced starting from Artifactory version 7.100.x
artifactory.package.handler.nuget=true
artifactory.nuget.ph.relevancy.sorting=true


Step 3 - Save and Restart Artifactory
Important:

A restart is required for the changes to take effect.

bash

# Linux (systemd):
sudo systemctl restart artifactory

# Docker:
docker restart artifactory

# Kubernetes/Helm:
kubectl rollout restart statefulset artifactory -n <namespace>


What Each Property Does:
Property
Value
Effect
Scope
artifactory.package.handler.nuget
true
Enables improved NuGet package handler logic. Fixes misinterpretation of the projectUrl field in NuGet package metadata, resulting in more accurate package processing and search results.
Remote & Virtual repositories
artifactory.nuget.ph.relevancy.sorting
true
Enables relevancy-based sorting of NuGet search results. Ensures the most relevant packages appear first within the 1,000-result search limit.
Virtual repositories only


Expected Outcome After Applying the Properties
Once both properties are set to true and Artifactory is restarted, the following improvements are expected:
  • NuGet search results from the Remote repository will more closely match results from querying the upstream registry directly
  • NuGet search results from the Virtual repository will be sorted by relevance, with the most relevant packages appearing first
  • Metadata for packages containing a projectUrl field will be processed correctly
Note:

 A Virtual repository that includes local repositories will still return a slightly different result set than a pure Remote repository - this is expected and by design, since the Virtual repository aggregates results from all its members including local repositories. The properties above optimize the ordering and accuracy of those results but do not change the fundamental aggregation behavior.
Below are the outcomes:
Execute command on NuGet registry directly
nuget search newtonsoft.json -Source https://www.nuget.org/api/v2/
  GET 
https://www.nuget.org/api/v2/Search()?$filter=IsLatestVersion&searchTerm='newtonsoft.json'&targetFramework=''&includePrerelease=false&$skip=0&$top=20&semVerLevel=2.0.0
  OK 
https://www.nuget.org/api/v2/Search()?$filter=IsLatestVersion&searchTerm='newtonsoft.json'&targetFramework=''&includePrerelease=false&$skip=0&$top=20&semVerLevel=2.0.0 
406ms
====================
Source: https://www.nuget.org/api/v2/
--------------------
> Newtonsoft.Json | 13.0.3 | Downloads: 2,147,483,647
  Json.NET is a popular high-performance JSON framework for .NET
--------------------
> Newtonsoft.Json.Bson | 1.0.3 | Downloads: 946,851,376
  Json.NET BSON adds support for reading and writing BSON
--------------------
> Newtonsoft.Json.Schema | 4.0.1 | Downloads: 65,594,946
  Json.NET Schema is a complete and easy-to-use JSON Schema framework for .NET
--------------------
> Microsoft.AspNetCore.Mvc.NewtonsoftJson | 9.0.5 | Downloads: 551,081,572
  ASP.NET Core MVC features that use Newtonsoft.Json. Includes input and output formatters for JSON 
an...
--------------------
> Swashbuckle.AspNetCore.Newtonsoft | 8.1.1 | Downloads: 126,900,096
  Swagger Generator opt-in component to support Newtonsoft.Json serializer behaviors
--------------------
> GraphQL.NewtonsoftJson | 8.5.0 | Downloads: 23,967,023
  JSON.NET serializer for GraphQL.NET
--------------------
> NJsonSchema.NewtonsoftJson | 11.3.2 | Downloads: 25,760,061
  JSON Schema reader, generator and validator for .NET
--------------------
> Microsoft.Azure.Core.NewtonsoftJson | 2.0.0 | Downloads: 15,745,905
  This library contains converters dependent on the Newtonsoft.Json package for use with Azure.Core.
--------------------
> Refit.Newtonsoft.Json | 8.0.0 | Downloads: 23,911,511
  Refit Serializers for Newtonsoft.Json
--------------------
> RestSharp.Serializers.NewtonsoftJson | 112.1.0 | Downloads: 22,220,572
  Simple REST and HTTP API Client
--------------------
> MassTransit.Newtonsoft | 8.4.1 | Downloads: 12,988,368
  MassTransit Newtonsoft JSON/BSON support; MassTransit provides a developer-focused, modern 
platform ...
--------------------
> App.Metrics.Formatters.Json | 4.3.0 | Downloads: 40,732,273
  App Metrics Formatters for metrics  and environment data to JSON using Newtonsoft.Json.
--------------------
> NServiceBus.Newtonsoft.Json | 4.1.0 | Downloads: 13,363,948
  Json.NET serializer for NServiceBus
--------------------
> Microsoft.AspNetCore.SignalR.Protocols.NewtonsoftJson | 9.0.5 | Downloads: 26,494,079
  Implements the SignalR Hub Protocol using Newtonsoft.Json.

  This package was built from the source c...
--------------------
> RestSharp.Newtonsoft.Json | 1.5.1 | Downloads: 5,506,098
  Restores Newtonsoft.JSON as the default serializer for RestSharp.
--------------------
> GraphQL.Client.Serializer.Newtonsoft | 6.1.0 | Downloads: 23,224,234
  A serializer implementation for GraphQL.Client using Newtonsoft.Json as underlying JSON library
--------------------
> CloudNative.CloudEvents.NewtonsoftJson | 2.8.0 | Downloads: 4,477,205
  JSON support for the CNCF CloudEvents SDK, based on Newtonsoft.Json.
--------------------
> JsonConverter.Newtonsoft.Json | 0.7.1 | Downloads: 4,987,575
  Implementation for IJsonConverter using Newtonsoft.Json
--------------------
> StackExchange.Redis.Extensions.Newtonsoft | 11.0.0 | Downloads: 15,740,852
  StackExchange.Redis.Extensions is a library that extends StackExchange.Redis allowing you a set 
of f...
--------------------
> UUID.Serialization.Newtonsoft | 1.1.1 | Downloads: 7,879,930
  Provides Newtonsoft.Json serialization support for the UUID library, enabling seamless JSON 
serializ...
--------------------
Execute command on Remote V3:
nuget search newtonsoft.json -Source oremoteV3
====================
Source: oremoteV3
--------------------
> Newtonsoft.Json | 13.0.3 | Downloads: 6,204,298,168
  Json.NET is a popular high-performance JSON framework for .NET
--------------------
> Newtonsoft.Json.Bson | 1.0.3 | Downloads: 946,851,376
  Json.NET BSON adds support for reading and writing BSON
--------------------
> Newtonsoft.Json.Schema | 4.0.1 | Downloads: 65,594,946
  Json.NET Schema is a complete and easy-to-use JSON Schema framework for .NET
--------------------
> Microsoft.AspNetCore.Mvc.NewtonsoftJson | 9.0.5 | Downloads: 551,081,572
  ASP.NET Core MVC features that use Newtonsoft.Json. Includes input and output formatters for JSON 
an...
--------------------
> Swashbuckle.AspNetCore.Newtonsoft | 8.1.1 | Downloads: 126,900,096
  Swagger Generator opt-in component to support Newtonsoft.Json serializer behaviors
--------------------
> GraphQL.NewtonsoftJson | 8.5.0 | Downloads: 23,967,023
  JSON.NET serializer for GraphQL.NET
--------------------
> NJsonSchema.NewtonsoftJson | 11.3.2 | Downloads: 25,760,061
  JSON Schema reader, generator and validator for .NET
--------------------
> Microsoft.Azure.Core.NewtonsoftJson | 2.0.0 | Downloads: 15,745,905
  This library contains converters dependent on the Newtonsoft.Json package for use with Azure.Core.
--------------------
> Refit.Newtonsoft.Json | 8.0.0 | Downloads: 23,911,511
  Refit Serializers for Newtonsoft.Json
--------------------
> RestSharp.Serializers.NewtonsoftJson | 112.1.0 | Downloads: 22,220,572
  Simple REST and HTTP API Client
--------------------
> MassTransit.Newtonsoft | 8.4.1 | Downloads: 12,988,368
  MassTransit Newtonsoft JSON/BSON support; MassTransit provides a developer-focused, modern 
platform ...
--------------------
> App.Metrics.Formatters.Json | 4.3.0 | Downloads: 40,732,273
  App Metrics Formatters for metrics  and environment data to JSON using Newtonsoft.Json.
--------------------
> NServiceBus.Newtonsoft.Json | 4.1.0 | Downloads: 13,363,948
  Json.NET serializer for NServiceBus
--------------------
> Microsoft.AspNetCore.SignalR.Protocols.NewtonsoftJson | 9.0.5 | Downloads: 26,494,079
  Implements the SignalR Hub Protocol using Newtonsoft.Json.

  This package was built from the source c...
--------------------
> RestSharp.Newtonsoft.Json | 1.5.1 | Downloads: 5,506,098
  Restores Newtonsoft.JSON as the default serializer for RestSharp.
--------------------
> GraphQL.Client.Serializer.Newtonsoft | 6.1.0 | Downloads: 23,224,234
  A serializer implementation for GraphQL.Client using Newtonsoft.Json as underlying JSON library
--------------------
> CloudNative.CloudEvents.NewtonsoftJson | 2.8.0 | Downloads: 4,477,205
  JSON support for the CNCF CloudEvents SDK, based on Newtonsoft.Json.
--------------------
> JsonConverter.Newtonsoft.Json | 0.7.1 | Downloads: 4,987,575
  Implementation for IJsonConverter using Newtonsoft.Json
--------------------
> StackExchange.Redis.Extensions.Newtonsoft | 11.0.0 | Downloads: 15,740,852
  StackExchange.Redis.Extensions is a library that extends StackExchange.Redis allowing you a set 
of f...
--------------------
> UUID.Serialization.Newtonsoft | 1.1.1 | Downloads: 7,879,930
  Provides Newtonsoft.Json serialization support for the UUID library, enabling seamless JSON 
serializ...
--------------------
Execute command on Remote V2:
nuget search newtonsoft.json -Source oremoteV2
  GET 
https://RT.jfrog.io/artifactory/api/nuget/nuget-remote/Search()?$filter=IsLatestVersion&searchTerm='newtonsoft.json'&targetFramework=''&includePrerelease=false&$skip=0&$top=20&semVerLevel=2.0.0
  OK 
https://RT.jfrog.io/artifactory/api/nuget/nuget-remote/Search()?$filter=IsLatestVersion&searchTerm='newtonsoft.json'&targetFramework=''&includePrerelease=false&$skip=0&$top=20&semVerLevel=2.0.0 
874ms
====================
Source: oremoteV2
--------------------
> Newtonsoft.Json | 13.0.3 | Downloads: 2,147,483,647
  Json.NET is a popular high-performance JSON framework for .NET
--------------------
> Newtonsoft.Json.Bson | 1.0.3 | Downloads: 946,851,376
  Json.NET BSON adds support for reading and writing BSON
--------------------
> Newtonsoft.Json.Schema | 4.0.1 | Downloads: 65,594,946
  Json.NET Schema is a complete and easy-to-use JSON Schema framework for .NET
--------------------
> Microsoft.AspNetCore.Mvc.NewtonsoftJson | 9.0.5 | Downloads: 551,081,572
  ASP.NET Core MVC features that use Newtonsoft.Json. Includes input and output formatters for JSON 
an...
--------------------
> Swashbuckle.AspNetCore.Newtonsoft | 8.1.1 | Downloads: 126,900,096
  Swagger Generator opt-in component to support Newtonsoft.Json serializer behaviors
--------------------
> GraphQL.NewtonsoftJson | 8.5.0 | Downloads: 23,967,023
  JSON.NET serializer for GraphQL.NET
--------------------
> NJsonSchema.NewtonsoftJson | 11.3.2 | Downloads: 25,760,061
  JSON Schema reader, generator and validator for .NET
--------------------
> Microsoft.Azure.Core.NewtonsoftJson | 2.0.0 | Downloads: 15,745,905
  This library contains converters dependent on the Newtonsoft.Json package for use with Azure.Core.
--------------------
> Refit.Newtonsoft.Json | 8.0.0 | Downloads: 23,911,511
  Refit Serializers for Newtonsoft.Json
--------------------
> RestSharp.Serializers.NewtonsoftJson | 112.1.0 | Downloads: 22,220,572
  Simple REST and HTTP API Client
--------------------
> MassTransit.Newtonsoft | 8.4.1 | Downloads: 12,988,368
  MassTransit Newtonsoft JSON/BSON support; MassTransit provides a developer-focused, modern 
platform ...
--------------------
> App.Metrics.Formatters.Json | 4.3.0 | Downloads: 40,732,273
  App Metrics Formatters for metrics  and environment data to JSON using Newtonsoft.Json.
--------------------
> NServiceBus.Newtonsoft.Json | 4.1.0 | Downloads: 13,363,948
  Json.NET serializer for NServiceBus
--------------------
> Microsoft.AspNetCore.SignalR.Protocols.NewtonsoftJson | 9.0.5 | Downloads: 26,494,079
  Implements the SignalR Hub Protocol using Newtonsoft.Json.

  This package was built from the source c...
--------------------
> RestSharp.Newtonsoft.Json | 1.5.1 | Downloads: 5,506,098
  Restores Newtonsoft.JSON as the default serializer for RestSharp.
--------------------
> GraphQL.Client.Serializer.Newtonsoft | 6.1.0 | Downloads: 23,224,234
  A serializer implementation for GraphQL.Client using Newtonsoft.Json as underlying JSON library
--------------------
> CloudNative.CloudEvents.NewtonsoftJson | 2.8.0 | Downloads: 4,477,205
  JSON support for the CNCF CloudEvents SDK, based on Newtonsoft.Json.
--------------------
> JsonConverter.Newtonsoft.Json | 0.7.1 | Downloads: 4,987,575
  Implementation for IJsonConverter using Newtonsoft.Json
--------------------
> StackExchange.Redis.Extensions.Newtonsoft | 11.0.0 | Downloads: 15,740,852
  StackExchange.Redis.Extensions is a library that extends StackExchange.Redis allowing you a set 
of f...
--------------------
> UUID.Serialization.Newtonsoft | 1.1.1 | Downloads: 7,879,930
  Provides Newtonsoft.Json serialization support for the UUID library, enabling seamless JSON 
serializ...
--------------------
Execute command on Virtual V2:
nuget search newtonsoft.json -Source omervirV2
  GET 
https://RT.jfrog.io/artifactory/api/nuget/nuget/Search()?$filter=IsLatestVersion&searchTerm='newtonsoft.json'&targetFramework=''&includePrerelease=false&$skip=0&$top=20&semVerLevel=2.0.0
  OK 
https://RT.jfrog.io/artifactory/api/nuget/nuget/Search()?$filter=IsLatestVersion&searchTerm='newtonsoft.json'&targetFramework=''&includePrerelease=false&$skip=0&$top=20&semVerLevel=2.0.0 
932ms
====================
Source: omervirV2
--------------------
> Newtonsoft.Json | 13.0.3 | Downloads: 2,147,483,647
  Json.NET is a popular high-performance JSON framework for .NET
--------------------
> Newtonsoft.Json.Bson | 1.0.3 | Downloads: 975,568,174
  Json.NET BSON adds support for reading and writing BSON
--------------------
> Newtonsoft.Json.Schema | 4.0.1 | Downloads: 67,468,129
  Json.NET Schema is a complete and easy-to-use JSON Schema framework for .NET
--------------------
> Refit.Newtonsoft.Json | 8.0.0 | Downloads: 25,071,126
  Refit Serializers for Newtonsoft.Json
--------------------
> NServiceBus.Newtonsoft.Json | 4.1.0 | Downloads: 13,744,268
  Json.NET serializer for NServiceBus
--------------------
> RestSharp.Newtonsoft.Json | 1.5.1 | Downloads: 5,619,012
  Restores Newtonsoft.JSON as the default serializer for RestSharp.
--------------------
> JsonConverter.Newtonsoft.Json | 0.7.2 | Downloads: 5,306,990
  Implementation for IJsonConverter using Newtonsoft.Json
--------------------
> Microsoft.AspNetCore.Mvc.NewtonsoftJson | 9.0.6 | Downloads: 568,854,136
  ASP.NET Core MVC features that use Newtonsoft.Json. Includes input and output formatters for JSON 
an...
--------------------
> Swashbuckle.AspNetCore.Newtonsoft | 9.0.1 | Downloads: 131,496,552
  Swagger Generator opt-in component to support Newtonsoft.Json serializer behaviors
--------------------
> App.Metrics.Formatters.Json | 4.3.0 | Downloads: 41,659,924
  App Metrics Formatters for metrics  and environment data to JSON using Newtonsoft.Json.
--------------------
> NJsonSchema.NewtonsoftJson | 11.3.2 | Downloads: 29,145,696
  JSON Schema reader, generator and validator for .NET
--------------------
> Microsoft.AspNetCore.SignalR.Protocols.NewtonsoftJson | 9.0.6 | Downloads: 27,406,092
  Implements the SignalR Hub Protocol using Newtonsoft.Json.

  This package was built from the source c...
--------------------
> GraphQL.NewtonsoftJson | 8.5.0 | Downloads: 25,440,580
  JSON.NET serializer for GraphQL.NET
--------------------
> GraphQL.Client.Serializer.Newtonsoft | 6.1.0 | Downloads: 24,283,863
  A serializer implementation for GraphQL.Client using Newtonsoft.Json as underlying JSON library
--------------------
> RestSharp.Serializers.NewtonsoftJson | 112.1.0 | Downloads: 23,085,591
  Simple REST and HTTP API Client
--------------------
> Microsoft.Azure.Core.NewtonsoftJson | 2.0.0 | Downloads: 16,903,752
  This library contains converters dependent on the Newtonsoft.Json package for use with Azure.Core.
--------------------
> StackExchange.Redis.Extensions.Newtonsoft | 11.0.0 | Downloads: 16,187,181
  StackExchange.Redis.Extensions is a library that extends StackExchange.Redis allowing you a set 
of f...
--------------------
> MassTransit.Newtonsoft | 8.4.1 | Downloads: 13,871,623
  MassTransit Newtonsoft JSON/BSON support; MassTransit provides a developer-focused, modern 
platform ...
--------------------
> CloudNative.CloudEvents.NewtonsoftJson | 2.8.0 | Downloads: 4,699,480
  JSON support for the CNCF CloudEvents SDK, based on Newtonsoft.Json.
--------------------
Execute command on Virtual V3:
nuget search newtonsoft.json -Source omervirV3
====================
Source: omervirV3
--------------------
> Newtonsoft.Json | 13.0.3 | Downloads: 6,377,073,834
  Json.NET is a popular high-performance JSON framework for .NET
--------------------
> Newtonsoft.Json.Bson | 1.0.3 | Downloads: 975,568,174
  Json.NET BSON adds support for reading and writing BSON
--------------------
> Refit.Newtonsoft.Json | 8.0.0 | Downloads: 25,071,126
  Refit Serializers for Newtonsoft.Json
--------------------
> NServiceBus.Newtonsoft.Json | 4.1.0 | Downloads: 13,744,268
  Json.NET serializer for NServiceBus
--------------------
> RestSharp.Newtonsoft.Json | 1.5.1 | Downloads: 5,619,012
  Restores Newtonsoft.JSON as the default serializer for RestSharp.
--------------------
> JsonConverter.Newtonsoft.Json | 0.7.2 | Downloads: 5,306,990
  Implementation for IJsonConverter using Newtonsoft.Json
--------------------
> Newtonsoft.Json.Schema | 4.0.1 | Downloads: 67,468,129
  Json.NET Schema is a complete and easy-to-use JSON Schema framework for .NET
--------------------
> Microsoft.AspNetCore.Mvc.NewtonsoftJson | 9.0.6 | Downloads: 568,854,136
  ASP.NET Core MVC features that use Newtonsoft.Json. Includes input and output formatters for JSON 
an...
--------------------
> Swashbuckle.AspNetCore.Newtonsoft | 9.0.1 | Downloads: 131,496,552
  Swagger Generator opt-in component to support Newtonsoft.Json serializer behaviors
--------------------
> App.Metrics.Formatters.Json | 4.3.0 | Downloads: 41,659,924
  App Metrics Formatters for metrics  and environment data to JSON using Newtonsoft.Json.
--------------------
> NJsonSchema.NewtonsoftJson | 11.3.2 | Downloads: 29,145,696
  JSON Schema reader, generator and validator for .NET
--------------------
> Microsoft.AspNetCore.SignalR.Protocols.NewtonsoftJson | 9.0.6 | Downloads: 27,406,092
  Implements the SignalR Hub Protocol using Newtonsoft.Json.

  This package was built from the source c...
--------------------
> GraphQL.NewtonsoftJson | 8.5.0 | Downloads: 25,440,580
  JSON.NET serializer for GraphQL.NET
--------------------
> GraphQL.Client.Serializer.Newtonsoft | 6.1.0 | Downloads: 24,283,863
  A serializer implementation for GraphQL.Client using Newtonsoft.Json as underlying JSON library
--------------------
> RestSharp.Serializers.NewtonsoftJson | 112.1.0 | Downloads: 23,085,591
  Simple REST and HTTP API Client
--------------------
> Microsoft.Azure.Core.NewtonsoftJson | 2.0.0 | Downloads: 16,903,752
  This library contains converters dependent on the Newtonsoft.Json package for use with Azure.Core.
--------------------
> StackExchange.Redis.Extensions.Newtonsoft | 11.0.0 | Downloads: 16,187,181
  StackExchange.Redis.Extensions is a library that extends StackExchange.Redis allowing you a set 
of f...
--------------------
> MassTransit.Newtonsoft | 8.4.1 | Downloads: 13,871,623
  MassTransit Newtonsoft JSON/BSON support; MassTransit provides a developer-focused, modern 
platform ...
--------------------
> UUID.Serialization.Newtonsoft | 1.1.1 | Downloads: 7,879,994
  Provides Newtonsoft.Json serialization support for the UUID library, enabling seamless JSON 
serializ...
--------------------
> CloudNative.CloudEvents.NewtonsoftJson | 2.8.0 | Downloads: 4,699,480
  JSON support for the CNCF CloudEvents SDK, based on Newtonsoft.Json.
--------------------