Your project keeps a local copy of your help centre's settings and article history, and that copy drifts as you and your team make changes on SupportPages.io. Running `wtfm sync` pulls the latest down, so you always write against the current picture. ## Prerequisites - A project set up with `wtfm init` and linked to your help centre on SupportPages.io. - Signed in to SupportPages.io, with `wtfm login` if you aren't already. - A terminal open in your project folder. ## Steps ### Step 1: Open your project folder In your terminal, change into the project you set up with `wtfm init`. ```bash cd path/to/your-product ``` `wtfm sync` reads the link this folder already saved, so run it from there. ### Step 2: Run the sync command From your project folder, run the sync command. ```bash wtfm sync ``` SupportPages.io refreshes this project's settings and article history, then prints a short report of what it found. Add `--json` if you need the same result as data in a script. ![Run the sync command](https://help.wtfm.sh/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MTI0MjIsInB1ciI6ImJsb2JfaWQifX0=--2ac0977e0af2aec111d0d4c718a8766980e12748/block_run-sync.png) ## What the report tells you - The help centre name and URL confirm which help centre this folder is linked to. - `synced` marks an article that matches what's on SupportPages.io. - `remote_changed` means someone edited it on the help centre; open the editor link in the report and review before uploading local changes. - `local_changes` means you have edits that aren't on the help centre yet. - `remote_only` is an article that exists on the help centre but not in this folder. - `deleted_remotely` means it was removed on SupportPages.io, and the report will never recreate it for you. - Video walkthroughs are listed the same way, with their own status and, when shared, a review link. ## Tips - Run `wtfm sync` before you start writing, so you're never working from settings that changed on the server. - Sync only reads from SupportPages.io — your local articles are left exactly as they are. Use `wtfm publish` when you want to send them up. - Already signed in? Sync won't ask you to log in again. ## Summary Run `wtfm sync` from your project folder whenever you want the current help centre settings and article history. Read the report, review anything that changed on the server, and you're ready to write.