diff --git a/articles/fleet-maintained-apps.md b/articles/fleet-maintained-apps.md
index a92b57febc..aaa3907416 100644
--- a/articles/fleet-maintained-apps.md
+++ b/articles/fleet-maintained-apps.md
@@ -67,9 +67,11 @@ A streamlined flow for pulling the latest version of a Fleet-maintained app is [
 
 ## Manage apps with GitOps
 
-To manage Fleet-maintained apps using Fleet's best practice GitOps, check out the `software` key in the [GitOps reference documentation](https://fleetdm.com/docs/using-fleet/gitops#software). There is a `fleet_maintained_apps` key you can use to specify via slug a list of apps. This makes it even more simple to add additional apps available for your fleet.
+To manage Fleet-maintained apps using Fleet's best practice GitOps, check out `fleet_maintained_apps`, found under the
+`software` key, in the
+[GitOps reference documentation](https://fleetdm.com/docs/configuration/yaml-files#fleet-maintained-apps).
 
-> Note: with GitOps enabled, any Fleet-maintained apps added using the web UI will not persist.
+> Note: with GitOps enabled, any Fleet-maintained apps added using the web UI will not persist if not also added in YAML.
 
 ## How does Fleet maintain these apps?
 
diff --git a/docs/Configuration/yaml-files.md b/docs/Configuration/yaml-files.md
index c56cd40bdd..1d2cb662b8 100644
--- a/docs/Configuration/yaml-files.md
+++ b/docs/Configuration/yaml-files.md
@@ -414,7 +414,7 @@ The `software` section allows you to configure packages, Apple App Store apps, a
 - `app_store_apps` is a list of Apple App Store apps.
 - `fleet_maintained_apps` is a list of Fleet-maintained apps.
 
-Currently, you can specify `install_software` in the [`policies` YAML](#policies) to automatically install a custom package or App Store app when a host fails a policy. Support for Fleet-maintained apps is coming soon.
+Currently, you can specify `install_software` in the [`policies` YAML](#policies) to automatically install a custom package or App Store app when a host fails a policy. [Automatic install support for Fleet-maintained apps](https://github.com/fleetdm/fleet/issues/29584) is coming soon.
 
 #### Example
 
@@ -514,9 +514,9 @@ Currently, one app for each of an App Store app's supported platforms are added.
 
 ### fleet_maintained_apps
 
-- `fleet_maintained_apps` is a list of Fleet-maintained apps. To find the `slug`, head to **Software > Add software** and select a Fleet-maintained app. From there, select **Show details**. You can also see the list [here in GitHub](https://github.com/fleetdm/fleet/blob/main/ee/maintained-apps/outputs/apps.json).
+- `fleet_maintained_apps` is a list of Fleet-maintained apps. Provide the `slug` field to include a Fleet-maintained app on a team. To find the `slug`, head to **Software > Add software** and select a Fleet-maintained app, then select **Show details**. You can also see the [list of app slugs on GitHub](https://github.com/fleetdm/fleet/blob/main/ee/maintained-apps/outputs/apps.json).
 
-Currently, Fleet-maintained apps do not auto-update. To update to the latest version of a Fleet-maintained app, head to the Fleet UI, find the software on the **Software** page, and delete the app (**Actions > Delete**). Then, on the next GitOps run, the latest version will be added.
+Currently, Fleet-maintained apps will be updated to the latest version published by Fleet when GitOps runs, [with the exception of Chrome](https://github.com/fleetdm/fleet/issues/30325).
 
 Fleet-maintained apps have default categories. You can see the default categories in the [Fleet-maintained app metadata on GitHub](https://github.com/fleetdm/fleet/tree/main/ee/maintained-apps/outputs). If you do not specify `categories` when adding a self-service Fleet-maintained app, the default categories will be used.