diff --git a/src/dotnet/commands/dotnet-tool/install/LocalizableStrings.resx b/src/dotnet/commands/dotnet-tool/install/LocalizableStrings.resx
index 9705509b6..2f818bfe8 100644
--- a/src/dotnet/commands/dotnet-tool/install/LocalizableStrings.resx
+++ b/src/dotnet/commands/dotnet-tool/install/LocalizableStrings.resx
@@ -163,10 +163,13 @@ Tool '{1}' (version '{2}') was successfully installed.
Tool '{0}' failed to install.
-
- Tool '{0}' failed to install. You may need to specify the version using
+
+ Tool '{0}' failed to install. This failure may have been caused by:
- dotnet tool install -g {0} --version <version>
+* You are attempting to install a preview release and did not use the --version option to specify the version.
+* A package by this name was found, but it was not a .NET Core tool.
+* The required NuGet feed cannot be accessed, perhaps because of an Internet connection problem.
+* You mistyped the name of the tool.Tool '{0}' failed to install. Please contact the tool author for assistance.
diff --git a/src/dotnet/commands/dotnet-tool/install/ToolInstallCommandLowLevelErrorConverter.cs b/src/dotnet/commands/dotnet-tool/install/ToolInstallCommandLowLevelErrorConverter.cs
index b73409a32..8323696dc 100644
--- a/src/dotnet/commands/dotnet-tool/install/ToolInstallCommandLowLevelErrorConverter.cs
+++ b/src/dotnet/commands/dotnet-tool/install/ToolInstallCommandLowLevelErrorConverter.cs
@@ -18,7 +18,7 @@ namespace Microsoft.DotNet.Tools.Tool.Install
userFacingMessages = new[]
{
ex.Message,
- string.Format(LocalizableStrings.ToolInstallationFailedWithExplicitVersionGuide, packageId),
+ string.Format(LocalizableStrings.ToolInstallationFailedWithRestoreGuidance, packageId),
};
}
else if (ex is ToolConfigurationException)
diff --git a/src/dotnet/commands/dotnet-tool/install/xlf/LocalizableStrings.cs.xlf b/src/dotnet/commands/dotnet-tool/install/xlf/LocalizableStrings.cs.xlf
index 87ff9977c..e89bdafbd 100644
--- a/src/dotnet/commands/dotnet-tool/install/xlf/LocalizableStrings.cs.xlf
+++ b/src/dotnet/commands/dotnet-tool/install/xlf/LocalizableStrings.cs.xlf
@@ -119,13 +119,19 @@ Nástroj {1} (verze {2}) byl úspěšně nainstalován.
Tool '{0}' failed to install.
-
-
+ Tool '{0}' failed to install. This failure may have been caused by:
- dotnet tool install -g {0} --version <version>
+* You are attempting to install a preview release and did not use the --version option to specify the version.
+* A package by this name was found, but it was not a .NET Core tool.
+* The required NuGet feed cannot be accessed, perhaps because of an Internet connection problem.
+* You mistyped the name of the tool.