From 81bc4a3f92463b54bbc09bfbf48632c785e58545 Mon Sep 17 00:00:00 2001
From: Marko Lisica <83164494+marko-lisica@users.noreply.github.com>
Date: Tue, 12 May 2026 18:28:58 +0200
Subject: [PATCH] Metadata extraction improvements (#45219)

Related to:
- #38356
- #38987
---
 articles/deploy-software-packages.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/articles/deploy-software-packages.md b/articles/deploy-software-packages.md
index 5a214604c9..3c56ba7d9d 100644
--- a/articles/deploy-software-packages.md
+++ b/articles/deploy-software-packages.md
@@ -45,6 +45,8 @@ Software installer uploads will fail if Fleet can't extract this metadata and ve
 
 .tar.gz archives are uploaded as-is without attempting to pull metadata, and will be added successfully as long as they are valid archives, and as long as install and uninstall scripts are supplied.
 
+> Fleet regularly enhances its metadata extraction logic, which can change how packages are matched to software inventory. When this happens, you may see this error: "The selected package is for different software." To fix it, delete and re-add the package.
+
 ### Script-only packages
 
 Script-only packages (`.sh` and `.ps1` files) are packages that only contain a script that runs directly on hosts without installing traditional software. The script file's contents become the install script.  The `.sh` files are supported for Linux hosts, and`.ps1` files for Windows hosts.