diff --git a/Custom-Factions.md b/Custom-Factions.md
index 1af41fe..70bc4d5 100644
--- a/Custom-Factions.md
+++ b/Custom-Factions.md
@@ -57,6 +57,27 @@ When changing a livery, if an aircraft is a Core DCS aircraft or module such as
 
 It is recommended, that your faction has access to all unit types, e.g. at least one tank, one IFV, one APC  and so on in order for the auto purchase option for the player and the ai to work.
 
+## Aircraft and ground unit names
+
+**New in DCS Liberation 4.0**
+
+Ground and air units are now named by the name of the unit in Liberation rather than the name in DCS. This was done so DCS updates can long longer break custom factions. Previously, if ED improved the name of a unit in DCS it would require an update to custom factions. Instead the faction files now use the Liberation names so we can prevent breakages from occurring.
+
+The names used are taken from the `variants` section of the unit info files in the `resources/units` directory. For example, `units/aircraft/FA-18C_hornet.yaml` contains the following:
+
+```
+variants:
+  CF-188 Hornet: {}
+  EF-18A+ Hornet: {}
+  F/A-18C Hornet (Lot 20): {}
+```
+
+In this example, there are three variants of the DCS F/A-18C Hornet unit. These "variants" are **name only**. The DCS unit type will be the F/A-18C module, but the name in the Liberation UI will be whichever variant is named in the faction file. This allows a Spain faction to pretend that an EF-18A+ is available in DCS.
+
+Ground units use the same format, but are located in `resources/units/ground_units`.
+
+Note that this currently does not apply to ships or any section that names a generator like navy groups, SAMs, EWRs, missiles, or coastal defenses. Ships will be migrated in a future release.
+
 # Example file
 
 Below is an example of a factions file :
@@ -68,48 +89,56 @@ Below is an example of a factions file :
   "name": "USAF Aggressors",
   "authors": "Khopa",
   "description": "<p>USAF aggresors.</p>",
+  "locales": [
+    "en_US"
+  ],
   "aircrafts": [
-    "F_15C",
-    "F_15E",
-    "F_14B",
-    "FA_18C_hornet",
-    "F_16C_50",
-    "A_10A",
-    "A_10C",
-    "AV8BNA",
-    "UH_1H",
-    "AH_64D",
-    "Ka_50",
-    "B_52H",
-    "B_1B",
-    "F_117A",
-    "Su_27"
+    "A-10A Thunderbolt II",
+    "A-10C Thunderbolt II (Suite 3)",
+    "AH-64D Apache Longbow",
+    "AV-8B Harrier II Night Attack",
+    "B-1B Lancer",
+    "B-52H Stratofortress",
+    "F-117A Nighthawk",
+    "F-14B Tomcat",
+    "F-15C Eagle",
+    "F-15E Strike Eagle",
+    "F-16CM Fighting Falcon (Block 50)",
+    "F/A-18C Hornet (Lot 20)",
+    "Ka-50 Hokum",
+    "SH-60B Seahawk",
+    "Su-27 Flanker-B",
+    "UH-1H Iroquois"
   ],
   "awacs": [
-    "E_3A"
+    "E-2C Hawkeye",
+    "E-3A"
   ],
   "tankers": [
-    "KC_135",
-    "KC130"
+    "KC-130",
+    "KC-135 Stratotanker",
+    "KC-135 Stratotanker MPRS",
+    "S-3B Tanker"
   ],
   "frontline_units": [
-    "MBT_M1A2_Abrams",
-    "MBT_Leopard_2",
-    "ATGM_M1134_Stryker",
-    "IFV_M2A2_Bradley",
-    "IFV_LAV_25",
-    "APC_M1043_HMMWV_Armament"
+    "LAV-25",
+    "Leopard 2A4",
+    "M1043 HMMWV (M2 HMG)",
+    "M1097 Heavy HMMWV Avenger",
+    "M1134 Stryker ATGM (BGM-71 TOW)",
+    "M1A2 Abrams",
+    "M2A2 Bradley"
   ],
   "artillery_units": [
-    "MLRS_M270",
-    "SPH_M109_Paladin"
+    "M109A6 Paladin",
+    "M270 Multiple Launch Rocket System"
   ],
   "logistics_units": [
-    "Transport_M818"
+    "Truck M818 6x6"
   ],
   "infantry_units": [
-    "Infantry_M4",
-    "Soldier_M249"
+    "Infantry M249",
+    "Infantry M4"
   ],
   "air_defenses": [
     "AvengerGenerator",
@@ -124,23 +153,24 @@ Below is an example of a factions file :
     "OliverHazardPerryGroupGenerator"
   ],
   "has_jtac": true,
-  "jtac_unit": "MQ_9_Reaper",
+  "jtac_unit": "MQ-9 Reaper",
   "liveries_overrides": {
-    "FA_18C_hornet": [
-      "NSAWC brown splinter",
+    "F/A-18C Hornet (Lot 20)": [
       "NAWDC black",
+      "NSAWC brown splinter",
       "VFC-12"
     ],
-    "F_15C": [
+    "F-15C Eagle": [
       "65th Aggressor SQN (WA) MiG",
       "65th Aggressor SQN (WA) MiG",
       "65th Aggressor SQN (WA) SUPER_Flanker"
     ],
-    "F_16C_50": [
+    "F-16CM Fighting Falcon (Block 50)": [
+      "64th_aggressor_squadron_ghost",
       "usaf 64th aggressor sqn - shark",
-      "usaf 64th aggressor sqn-splinter",
-      "64th_aggressor_squadron_ghost"
-    ], "F_14B": [
+      "usaf 64th aggressor sqn-splinter"
+    ],
+    "F-14B Tomcat": [
       "vf-74 adversary"
     ]
   }