Skip to content
Textual
Menu

Preferences, backups, and resetting

Move your setup safely and understand why older guides list different storage locations.

On this page

Use Textual's built-in export and import tools before working directly with its preference files. A small backup is considerably nicer than trying to remember every server setting from scratch.

Export or import your setup

Open Help → Advanced and use Export Preferences or Import Preferences. Export before moving to another Mac, switching distributions, downgrading, or attempting a reset.

Do not assume that a preferences export contains every credential, chat log, custom file or encryption identity. Keep appropriate separate backups for data you need, and confirm that the imported setup works before removing the original installation.

Why file locations changed

Textual 7.2.4 introduced sandboxing for the standalone app, and the app can also import data from an existing Mac App Store installation. Both changes explain why older documentation lists several container and group-container paths.

The original migration explanation describes the old locations and why copies may remain there. Keep those files until you have checked the new setup and decided that you do not need to return to the older installation.

Bundle identifiers containing codeux are part of existing Textual installations. Renaming those folders to match the new company is not a migration procedure.

Start fresh without losing your recovery path

Quit Textual and make a backup before changing files. If the problem affects one connection or preference, try correcting that setting first rather than removing all application data.

For a full reset, contact us with your Textual version and distribution so the relevant storage locations can be identified. The legacy reset reference preserves the older path list, but applying every deletion in it to a current Mac can remove data you wanted to keep.

The former Purge Textual helper is retained in the migration source archive and is not offered here as a current download. Do not disable macOS protections or run an unknown applet simply to reset preferences.

iCloud and App Store copies

The original iCloud synchronization feature was associated with the Mac App Store distribution, and its guide states that passwords were not synchronized. It is not a general feature promise for the current standalone release.

The legacy iCloud guide preserves the controls for older installations, including excluding a connection and removing stored data. Its offer of a free App Store promo code is historical.

Keep reading

Source material

Adapted from the Textual knowledgebase, with related historical details preserved in the legacy library.

Need a hand? Contact us about this guide.

Textual screenshot