Fergus Booking Forms

Export, import and duplicate a Fergus booking form

5 min read Fergus booking form

Duplicate copies a form inside the same account. Export and import move a form between accounts, or keep a copy of it. A duplicate keeps everything that belongs to the account. An export leaves it behind.

Before you start

  • Duplicate and Import Form are not available on the Free plan. Import is offered on Free only while the account has no forms. Export is open to every plan and to archived forms. See What each plan includes.
  • Import needs a Fergus credential on the account.

Step by step

Duplicate

  1. Open Forms, click ... on the form's row, then Duplicate.
  2. Type the Duplicate form name. It needs at least 3 characters and starts as the original's name followed by "copy".
  3. Switch off anything you don't want copied: Copy services, Copy calendars, Copy regions, Copy field settings and Copy notification recipients.
  4. Click Duplicate.

Copy services off also leaves out categories, calendars, regions and recipients, since they are set for each service. Copy calendars is staff, time groups, closed days and public holidays. Copy regions is the regions the form serves with their services and rosters. Copy field settings is the customer, site and job fields, questions, notes and scripts.

Every service, time group and category in the copy gets an id of its own, so the two forms share nothing. The copy keeps the staff, captcha and Geosearch settings of the original, since it is in the same account. It has no bookings, and it isn't on any page. Add its embed code to a page to use it.

Export

  1. Click ... on the form's row, then Export.

Your browser downloads a file named fergus-booking-form- and the form's name, ending .json. The dialog lists what the file Needs attention on, what was Left out and what was Kept.

Import

  1. Click Import Form and drop the file in, or choose it. The file can be up to 2 MB.
  2. On the review step, check the Form name. If a form already has the name, it suggests the name followed by "(imported)".
  3. Read the Needs attention and Left out lists. The Open button on a line takes you to the page that deals with it.
  4. Click Import.

The form is created as a new form, with new ids for its services, time groups and categories. It isn't on any page until its embed code is. When it finishes, Formpiece says "{name} has been imported. Choose its staff and add its embed code to a page before it takes bookings." and offers Open form.

What an export leaves out

Anything that belongs to the account it was made in.

  • Fergus users: staff rows, the default calendar's staff, region rosters, service team members and callback follow up users. A Fergus user belongs to one Fergus account, so you choose staff again.
  • Regions. They are drawn once on the account. Region search is switched off until you choose regions on the Regions page, and dynamic travel times that were limited to regions are switched off until you choose regions on the Geosearch page.
  • Notification recipients, in all four lists: booking, failed, date confirmation and callback.
  • Conditional intros, which name customers and sites in the account they came from.
  • The captcha and its credential.
  • The form's id, dates, archive state, whether its embed code was copied, the auth link page address and the internal Notes.
  • Anything else whose name says it is a key, a secret, a token, a tracking id, an integration, a webhook, a region id, a user id or a Fergus customer, site, job or contact id.
  • Scripts, event handlers and links that run code inside the form's text. The rest of that text is kept.

The file keeps services, categories, questions, notes and scripts, time group windows, closed weekdays and public holidays, field settings, the booking job type, headings and labels, layout, fonts and colours, intro, thank you and legal text, attachment settings, notification email wording, Geosearch settings and the event names for tracking.

What an import changes

  • Geosearch, Dynamic travel times (billed per route) and Travel blocks on the calendar come in switched off, whatever the file says. The review lists them as "Switched off on import". Turn them on again on the form's Geosearch page. An import never switches on anything that is billed.
  • The time zone is kept, and the review reminds you to check it is the time zone of the business that takes the bookings. A wrong zone makes every time offered wrong.
  • The Geosearch home location is kept but flagged, since it is the exporting business's address.
  • A redirect address is kept and flagged. One that isn't a web address is dropped and customers see the thank you message.
  • On a Free account the review adds a "Free plan" line listing the settings it saves but doesn't use until the account is on Business.

Services that have no staff after the import are listed as "Staff to pick". A service with nobody is not shown on the form.

When it goes wrong

"The file is not a Formpiece booking form export."

The file isn't one this page made, or it was edited and no longer parses. A file from another booking product is refused with a message saying which booking forms page to import it on.

"The file is incomplete and can't be imported."

The file is cut short or has a part of the wrong shape. Export the form again.

"The file is too large to be a booking form export." or "The form in the file is too large to import."

The file is over 2 MB, or the form inside it is too big to save.

A warning about a newer version, or settings "not recognised by this version"

The file came from a newer Formpiece. Settings this version doesn't know are kept as they are and may not work.

"A form named {name} already exists."

Change the Form name on the review step.

"Free accounts can have one form."

The account has a form already, archived or not.

The imported form shows Setup needed

That is expected. Staff, recipients and regions are left out of every export. Work down the checklist (see Use the setup checklist).

The duplicate has no one to take bookings

Copy services or Copy calendars was off. Open Service Calendars on the copy.