Guides/Full Automatic Sync Safety

Full Automatic Sync Safety

Use automatic import/export modes without creating loops or overwriting environment-specific data.
Updated 5 June 2026·Task guide

Outcome

You understand when Manual, Automatic Export, Automatic Import, Full Automatic Sync, and Workflow mode are appropriate, and how to avoid cascading data loss.

Video walkthrough

Video walkthrough coming soon.

The YouTube embed will appear here.
Risk level

High. Automatic write modes can surprise teams. Roll out gradually and monitor Activity.

Before you start

  • Know which site is source and which is target.
  • Use Git or backups before enabling automatic writes.
  • Exclude environment-specific options and secrets.

Mode guide

ConstantTypeDefaultDescription
BRICKSSYNC_STORAGE_PATHstring/uploads/bricks-syncDirectory for snapshot files.
BRICKSSYNC_MODEstringtwo-waySync direction.
BRICKSSYNC_AUTO_EXPORTboolfalseExport when Bricks saves.
BRICKSSYNC_GITboolfalseAuto-commit snapshots.

Safety checklist

  1. Start manual.
  2. Enable export-only first.
  3. Review JSON diffs.
  4. Add import automation only on staging.
  5. Use exclusions for environment-specific settings.
  6. Monitor Activity after every mode change.
Auto-export during import is guarded
Recent code prevents cascading data loss by avoiding auto-export during import operations, but automatic modes still deserve careful rollout.

Screenshots

Where to set it
Where to set it
Workflow mode
Workflow mode