Skip to main content

Run your first sync

After connecting credentials, pull your inventory into WordPress.

Open Booking Engine → Sync & Import ( Tools tab for Run sync now ).

Sync units page

Schedule​

Interval (hours) controls how often WordPress tries to run a scheduled full sync (via WP-Cron).

  • Allowed range: 1–168 hours.
  • Low-traffic sites: Cron only runs when someone visits the site, so the next run may wait until traffic triggers it—this is normal WordPress behaviour.

Saving the form reschedules the background job.

Kross booking engines (optional filter)​

If Kross is active, you can narrow full sync to room types whose payload includes selected be_enabled slugs:

  1. Click Refresh booking engines list from Kross to populate the checklist from the API.
  2. Leave every box unchecked to sync all room types (recommended starting point).
  3. Otherwise tick the engine slugs you want included.

Details: Syncing units.

Optional fields change how downloaded gallery files are named in the Media Library:

  • Filename prefix — Text before the unit name slug.
  • Filename suffix (before index) — Text after the slug and before the numeric index (e.g. -01).

Together the pattern is roughly: prefix + unit-slug + suffix + -NN + extension.
Existing files can be renamed in bulk later (see Gallery images).

Run sync now​

Click Run sync now for an immediate full sync.

With JavaScript (default wp-admin):

  • The plugin acquires a manual sync lock and processes units in batches via AJAX.
  • A Sync progress panel shows a live log and status until completion.

Without JavaScript or if the AJAX flow errors, the button falls back to a standard form POST (longer single request).

Results

  • On completion you should see created, updated, and skipped counts (and error text if something failed).
  • If another full sync is already running, you may see Another sync is already running—the lock can be held for a long time while work runs; see Syncing units for lock behaviour and Clear sync lock.

Sync completion notice

Last successful sync (if shown) comes from the plugin’s stored timestamp for the last completed run.

Sync lock troubleshooting​

On Booking Engine → Sync & Import → Tools, the Sync lock section shows whether a lock is set and offers Clear sync lock.

  • Only clear it when you are sure no job is running (e.g. stale lock after a crashed tab).

Find your units​

Open the Units menu in WordPress admin.

The list includes extra columns such as External ID, Provider, and Last sync so you can match WordPress rows to the booking system.

Units admin list

From here you can open a unit, use row actions like Sync now or Rename gallery files, or use bulk actions—see Syncing units.