diff --git a/nixosModules/clanCore/metadata.nix b/nixosModules/clanCore/metadata.nix
index 08eb8c6d0..28b8417d7 100644
--- a/nixosModules/clanCore/metadata.nix
+++ b/nixosModules/clanCore/metadata.nix
@@ -53,6 +53,11 @@ in
             '';
           };
           machine = mkOption {
+            description = ''
+              Settings of the machine.
+
+              This is a read-only attribute-set available to the machines of the clan.
+            '';
             default = {};
             type = types.submodule {
               options = {