Počínaje verzí 1.1 FreeCAD nativně podporuje verzované konfigurační a aplikační datové podadresáře. Pokud při prvním spuštění nové verze existuje konfigurační soubor, zobrazí se obrazovka s nabídkou přechodu na verzovanou strukturu zkopírováním existující konfigurace, pokračováním v používání „sdílené“ konfigurace z předchozí verze nebo spuštěním nové výchozí konfigurace.
Výchozí a doporučená možnost je migrace stávající konfigurace do nové pro novou verzi FreeCADu. Důsledkem je, že všechny nainstalované doplňky, konfigurační soubory a další uživatelská data jsou duplikovány do nového adresáře pro novou verzi. To znamená, že pokud spustíte starší verzi FreeCADu, bude moci používat starší konfiguraci a doplňky, čímž se zachová kompatibilita a zabrání se ztrátě dat nebo potenciálnímu neočekávanému chování, pokud se stará verze pokusí načíst nové konfigurační možnosti, aktualizované doplňky atd.
Uživatelé s velmi velkými adresáři dat aplikace (například kvůli instalaci knihovny dílů) možná nebudou chtít duplikovat všechna data a mohou se rozhodnout pokračovat v používání poslední nalezené konfigurační složky (u verzí starších než 1.1 se jedná o adresář bez verze). To s sebou nese riziko, že nová konfigurace nebo doplněk zabrání správnému načtení starší verze FreeCADu.
Tato volba vytvoří nový adresář s verzí konfigurace, ale nezkopíruje do něj nic, čímž zahájí novou instalaci s novými "výchozími továrními" nastaveními.
Pokud váš doplněk závisel na zaznamenávání/ukládání absolutní polohy svých souborů (namísto jejich polohy relativní k userAppDataDir nebo configDir), budete muset zjistit, že soubory byly migrovány, a aktualizovat uložené konfigurační proměnné. K dispozici je několik metod Pythonu, které tento proces usnadňují, zejména FreeCAD.ApplicationDirectories.versionStringForPath(major, minor) a FreeCAD.ApplicationDirectories.versionStringForPath.usingCurrentVersionConfig(pathToCheck).