diff --git a/pages/Configuring/Variables.md b/pages/Configuring/Variables.md
index 7d54442..3224dd0 100644
--- a/pages/Configuring/Variables.md
+++ b/pages/Configuring/Variables.md
@@ -349,6 +349,7 @@ _Subcategory `group:groupbar:`_
 | background_color | change the background color. (requires enabled `disable_hyprland_logo`) | color | 0x111111 |
 | close_special_on_empty | close the special workspace if the last window is removed | bool | true |
 | new_window_takes_over_fullscreen | if there is a fullscreen window, whether a new tiled window opened should replace the fullscreen one or stay behind. 0 - behind, 1 - takes over, 2 - unfullscreen the current fullscreen window [0/1/2] | int | 0 |
+| enable_hyprcursor | whether to enable hyprcursor support | bool | true |
 
 ## Binds
 
diff --git a/pages/Hypr Ecosystem/_index.md b/pages/Hypr Ecosystem/_index.md
index 4f3f2ee..9ea10b8 100644
--- a/pages/Hypr Ecosystem/_index.md	
+++ b/pages/Hypr Ecosystem/_index.md	
@@ -11,4 +11,5 @@ These docs always target latest -git branch of respective apps.
  - **[hyprpicker](./hyprpicker)**
  - **[hypridle](./hypridle)**
  - **[hyprlock](./hyprlock)**
- - **[xdg-desktop-portal-hyprland](./xdg-desktop-portal-hyprland)**
\ No newline at end of file
+ - **[xdg-desktop-portal-hyprland](./xdg-desktop-portal-hyprland)**
+ - **[hyprcursor](./hyprcursor)**
\ No newline at end of file
diff --git a/pages/Hypr Ecosystem/hyprcursor.md b/pages/Hypr Ecosystem/hyprcursor.md
new file mode 100644
index 0000000..574373b
--- /dev/null
+++ b/pages/Hypr Ecosystem/hyprcursor.md	
@@ -0,0 +1,21 @@
+hyprcursor is a new cursor theme format that has many advantages
+over the widely used xcursor.
+
+## Hyprcursor themes
+
+You will need to obtain those yourself. If you are on the discord server, see `#hyprcursor-themes`.
+
+Put your theme(s) in `~/.local/share/icons` or `~/.icons`
+
+You can set your theme with envvars, or with `hyprctl setcursor`.
+
+Env:
+ - `HYPRCURSOR_THEME` controls the theme.
+ - `HYPRCURSOR_SIZE` controls the cursor size.
+
+example snippet of `hyprland.conf`:
+
+```ini
+env = HYPRCURSOR_THEME,MyCursor
+env = HYPRCURSOR_SIZE,24
+```
\ No newline at end of file