PROBLEM
I'm experiencing one or more of the following issues when I use Chief Architect or Home Designer:
- The program freezes or hangs when creating a new plan or layout.
- The program freezes or hangs when accessing the User Catalog in the Library Browser.
- An error message appears when creating a new plan or layout.
- An error message appears stating the program cannot read or write to a library database.
- An error message appears stating it cannot read/find a toolbar configuration.
- Toolbars are missing when opening or creating a new plan.
- The User Catalog is missing in the Library Browser.
What might cause these symptoms?
RESOLUTION
Templates, toolbar and hotkey configurations, and the User Catalog are all stored in the program's Data folder, which resides in the user account's Documents folder by default. The symptoms above indicate that the program is having trouble accessing, reading, or writing to the files in its Data folder. The most common solution is to ensure that Chief Architect or Home Designer has Full Disk Access by following the instructions in KB-03125: Troubleshooting Error Messages Associated With the Program's Data Folder.
If you continue to experience problems after following the steps in the resource above, your Documents folder might be stored in iCloud Drive. Accessing program and plan files over a cloud storage service can cause the symptoms previously mentioned, as well as more severe issues, such as data loss and/or file corruption. In this article, we will cover determining whether your Documents folder is stored in iCloud Drive and, if necessary, creating a new Data folder for the program to reference that is not stored in iCloud Drive.
Determining whether your Documents folder is stored in iCloud Drive
- From the menu bar, click the Apple icon located in the top left corner, then click System Settings.
In macOS Monterey (12.6) or earlier, click System Preferences instead.
- Click Apple ID in the sidebar of the System Settings window, then click iCloud in the list on the right.
In macOS Mojave (10.14) or earlier, click the iCloud icon instead.
- If the iCloud Drive is On in the list on the right, click iCloud Drive. If it is Off, then your Documents folder is not stored in iCloud Drive, this may not be the cause of the issues you're experiencing, and you can proceed to the steps in the "Troubleshooting Chief Architect Software Closing Unexpectedly on a Mac" resource in the Related Articles section below.
- If the Desktop & Documents Folders switch is toggled on, then your Documents folder is stored in iCloud Drive. If it is toggled off, then your Documents folder is not stored in iCloud Drive, this may not be the cause of the issues you're experiencing, and you can proceed to the steps in the "Troubleshooting Chief Architect Software Closing Unexpectedly on a Mac" resource in the Related Articles section below.
If you'd like to remove your Desktop and Documents folders from iCloud Drive, you can do so by following the instructions in this Apple resource. For further assistance managing your iCloud storage, please contact Apple Support.
Creating a local Data folder
If your Documents folder is stored in iCloud Drive and you want to keep it there, follow the steps below to create a local Data folder anywhere outside of iCloud Drive. In this example, a Data folder will be created and placed in the Home/User folder.
- Open the Finder app or click once in an open area on the Desktop to make Finder the active application.
- From the menu bar, click Go> Home.
- From the menu bar, click File> New Folder.
The name of the new folder will be your program version with the first letter of each word capitalized, followed by the word "Data". In this example, a Data folder is created for Chief Architect Premier X15, so the folder name is: Chief Architect Premier X15 Data
Specifying the location of the Data folder in Preferences
- Open Chief Architect or Home Designer. From the menu bar, click Chief Architect/Home Designer> Preferences .
- On the Folders panel of the Preferences dialog:
- Click Browse to the right of the My Data Folder file path and select the new Data folder that was created in the section above.
If the Data folder was placed in the Home/User folder, the file path after selecting the new Data folder will be: /Users/username/Chief Architect Premier X15 Data/
- After specifying the correct folder location, click OK.
- In X14/2023 or later, a message will appear asking "Do you want to copy library files from the old User Library Folder to the new folder? Any files of the same name in the newly selected folder will be overwritten." This message refers to the contents of the User Catalog folder in the Library Browser, so if you want to copy those files to the new Data folder, click Yes. Otherwise, click No.
- A message will appear stating "Changing the user data folder requires a relaunch in order for all the changes to take effect. The data from your old user data folder will not be copied to the new location, the new folder will be reset to factory defaults." Click OK, then quit and reopen the app.
If you still receive error messages related to reading and writing files after specifying your new Data folder, please see the "Troubleshooting Chief Architect Software Closing Unexpectedly on a Mac" resource in the Related Articles section below.