diff --git a/modules/services/window-managers/i3-sway/lib/options.nix b/modules/services/window-managers/i3-sway/lib/options.nix
index 252562073..c21ad1ac3 100644
--- a/modules/services/window-managers/i3-sway/lib/options.nix
+++ b/modules/services/window-managers/i3-sway/lib/options.nix
@@ -95,6 +95,14 @@ let
       fonts = mkOption {
         type = with types; either (listOf str) fontOptions;
         default = { };
+        example = literalExample ''
+          {
+            names = [ "DejaVu Sans Mono" "FontAwesome5Free" ];
+            style = "Bold Semi-Condensed";
+            size = 11.0;
+          }
+        '';
+        description = "Font configuration for this bar.";
       };
 
       extraConfig = mkOption {
@@ -339,6 +347,14 @@ in {
   fonts = mkOption {
     type = with types; either (listOf str) fontOptions;
     default = { };
+    example = literalExample ''
+      {
+        names = [ "DejaVu Sans Mono" "FontAwesome5Free" ];
+        style = "Bold Semi-Condensed";
+        size = 11.0;
+      }
+    '';
+    description = "Font configuration for window titles, nagbar...";
   };
 
   window = mkOption {