All Deployment GuidesB2B Help Centre

For Company Administrators

Set Up Your Team’s App Settings

Set your company details, report wording and required sections once in your B2B Account. Every device that follows the profile picks them up, so each surveyor starts with the same set-up.

You choose which settings your organisation controls. Everything else stays with each surveyor. You can also give every device your AI and weather keys, and fix each device’s surveyor name and accreditations.

How Settings Profiles Work

You Pick What to Set

Each setting in a profile is either Set by Your Organisation or Left to each device. Devices keep their own value for anything you leave alone.

One Profile per Device

A device follows the profile that names it, otherwise the All Devices profile, otherwise none. An account has one All Devices profile, and a device can be in one profile only.

Personal Details Stay Personal

Surveyor email addresses, signatures and email server details never travel in a profile. Each surveyor enters those on their own device. Names and accreditations are assigned per device only if you choose to.

Devices apply a saved profile the next time the app opens or checks in, and an open app checks for changes regularly. Each saved version is applied once, so a surveyor can still change an unlocked setting until you save the profile again. To stop that, lock settings.

B2B Account

Create a Settings Profile

  1. 1

    Open App Settings

    Sign in to your B2B Account, open your organisation and choose App Settings. Staff with a view-only role can see profiles but not change them.

  2. 2

    Name the Profile and Choose Its Devices

    Choose New Profile. Give it a name, such as All Devices or North Team. Under Applies To, pick All Devices (including devices activated later) or Chosen Devices and tick the ones you want.

  3. 3

    Start From a Device (Optional)

    If one device is already set up the way you want, export its settings in the app from Settings → Backup & Transfer → Settings profiles → Export. Then upload that .json file under Start From a Device’s Settings. Its settings fill in the profile for you to check.

  4. 4

    Choose the Settings You Control

    The profile opens on All Settings: a tile for each section, grouped under This Profile, Company, Reports, and Surveys and Tools. Each tile says what the profile sets there, or Left to each device. Open a section, tick Set by Your Organisation beside each setting you want to control, then fill it in. Untick it to leave that setting to each device. Previous and Next at the bottom move between sections, and All Settings at the top takes you back to the tiles.

  5. 5

    Save the Profile

    Choose Save Profile. The list under Which Profile Each Device Follows shows which devices will pick it up.

A settings profile open on All Settings: tiles for each section grouped under This Profile, Company, Reports, and Surveys and Tools, each saying what it sets, such as Microsoft Foundry, 6 set, or Left to each device, with the Voice Input tile ringed in red (opens full size in a new tab)
A profile opens on its sections. Each tile says what the profile sets there.

Write Report Wording with Smart Build and AI Polish

The same writing tools as the app sit under Company History / About Us, Legal Disclaimer, Independent Surveyor Disclaimer, Client Sign-Off Statement and each Default Report Wording section. They appear once you tick Set by Your Organisation for that box.

Smart Build

Opens the same choices as Smart Build in the app. Tick the options that describe your company or the section, read the preview, then choose Use This Text. If the profile sets a Region, the wording follows it.

AI Polish

Type rough notes or paste your current wording, then choose AI Polish. It rewrites the box in clear, professional report English. Each administrator has a daily AI Polish allowance in the portal, and each run takes up to 12,000 characters.

Company History / About Us in a settings profile, ticked Set by Your Organisation, with the AI Polish and Smart Build buttons under the box ringed in red (opens full size in a new tab)
AI Polish and Smart Build sit under the box once you tick Set by Your Organisation.

In Report Text, Show Company History / About Us decides whether reports print your company history. Turned off, reports leave it out and the text is kept for later.

Turn On Client Sign-Off for Every Device

In the profile’s Client Sign-Off group, tick Set by Your Organisation and turn it on to add a step where the tenant, landlord, client or site contact signs on the surveyor’s device, just before the surveyor’s own sign-off. Choose Who Usually Signs and write the Client Sign-Off Statement they sign under, with Smart Build and AI Polish. The report prints the statement, the signature, their name and role, and when they signed. It needs version 1.7.3 or later on each device. See Client sign-off for how surveyors use it.

Make Every Surveyor Check Every Area

Area Checklists put a list of possible defects and checks to carry out on every external area and room of a General Inspection, grouped by element. The surveyor ticks what they find and what they do, gives each defect a severity and a short note, then marks the area complete, or records why it couldn’t be inspected. The report prints each area’s findings and a Schedule of Defects: every defect on the survey in one table, worst first. Checklists are on unless a profile hides them, and they are free on every edition. Home Surveys and Commercial Surveys keep their element ratings.

Make It Mandatory

Under Report Sections, set Required Sections and tick Area Checklists. Each area’s Next button then waits until its checklist is finished, and Share, Email and Print stay blocked until every area is. Which Areas Must Be Finished narrows it to rooms or outside areas.

Choose What Each Area Needs

In the Area Checklists group, set Needed Before an Area Is Marked Complete. Tick, for outside areas and rooms separately, the checks every area must have, such as photos or the limitations noted, and whether every defect found needs a severity. Surveyors see what is still needed, and Mark area complete waits for it.

Add Your Own Items

In the same group, set Your Own Checklist Items. Pick a list, such as Roof coverings or Bathroom, or every external area or every room, choose a possible defect or a check to carry out, and add it. Your items join the app’s own on every device that follows the profile, and your own checks can be made required too.

Schedule of Defects

The report lists every defect found in one table after the room findings, with a count of each severity, and the surveyor can save it as a spreadsheet. To leave it out, tick Schedule of Defects under Hidden Sections.

Switch Them Off

To take checklists off every area, tick Area Checklists under Hidden Sections. Anything already recorded on a survey is kept.

Area Checklists need version 1.8.0 or later on each device. Older versions ignore these settings and carry on as before. See Area checklists and Schedule of Defects for how surveyors use them.

Turn the AI Tools On or Off

The AI tools are AI Polish, AI photo analysis, Talk Through a Room, the AI executive summary, report translation and AI Transcribe. Turn them all on or off with All AI Tools, or each one on its own under Each Tool. A tool turned off is hidden in the app, and with every tool off so are the AI provider and keys in its Settings. Smart Build and dictation on the device stay, as they don’t use AI, and wording already in a survey stays. With AI Transcribe off, the microphone uses dictation on the device.

For Every Device

In App Settings, choose Edit AI Tools under AI Tools. Set All AI Tools, or set a tool under Each Tool to Off for every device or On for every device, then choose Save AI Tools. This always wins.

For One Surveyor’s Device

Open Devices and choose the device, or choose Assign Surveyor beside it under Which Profile Each Device Follows in App Settings. Then set All AI Tools or each tool under AI Tools on This Device and choose Save AI Tools. It applies to each tool the organisation leaves to each device.

Locked on Devices

Each switch you set is locked in the app’s Settings, which says your organisation set it. Leave a tool to each device and every surveyor chooses it for themselves.

The AI Tools card in App Settings, open for editing, with Off for every device chosen in the All AI Tools box, ringed in red, above the Each Tool boxes and Save AI Tools (opens full size in a new tab)
1. All of them, for every device: App Settings, then Edit AI Tools. Set All AI Tools to Off for every device and save.
The AI Tools card open for editing, with Report Translation under Each Tool set to Off for every device, ringed in red, and the other tools not set here (opens full size in a new tab)
2. One tool, for every device: under Each Tool, set Report Translation to Off for every device. The rest stay on.
AI Tools on This Device for one device, with AI Polish under Each Tool set to Off for this surveyor, ringed in red (opens full size in a new tab)
3. For one surveyor’s device: Assign Surveyor, then AI Tools on This Device. Here only AI Polish is off.

For each tool, a device takes the first of these that turns it on or off: AI Tools for the organisation, then AI Tools on This Device, then the surveyor’s own switches. At each, All AI Tools off turns every tool off, a tool’s own setting decides that tool, and All AI Tools on turns on the tools left to it. Settings reach devices at their next check-in from version 1.8.6; version 1.8.5 follows All AI Tools only. The AI Tools card says how many of your devices have it.

AI Tools on This Device with Report Translation set to On for this surveyor, under the note The organisation sets Report Translation for every device, which wins over this device's setting for it, ringed in red (opens full size in a new tab)
When the organisation sets a tool, the device’s setting for it waits, and the form says so.
The (i) beside AI Tools, ringed in red, open to list where a device’s AI Tools settings come from, in order (opens full size in a new tab)
The (i) beside AI Tools lists the same order.

Choose How the Microphone Writes

The microphone beside every text box in the app can use the device’s own dictation or AI transcription. Surveyors choose for themselves unless the profile sets it. It needs version 1.9.0 or later on each device.

Dictation on This Device

The phone’s own speech recognition, from Apple or Google. Free, works with no signal, and words appear as the surveyor speaks. It works well on iPhone and iPad.

AI Transcription

The app records what the surveyor says, then AI writes it down. Better with long notes, accents and building terms, and usually more accurate on Android. It needs signal, and uses the AI provider and keys the device follows.

Set It for Every Device

Open the profile’s Voice Input section, tick Set by Your Organisation and choose one. With Lock Settings on Devices, surveyors can’t switch, in Settings or by pressing and holding the microphone.

The Voice Input section of a settings profile, ringed in red: Set by Your Organisation ticked and AI Transcription chosen, with a note that AI transcription needs AI Transcribe on in AI Tools, and Photos and Survey Features buttons below to move between sections (opens full size in a new tab)
Voice Input: set it, and lock settings to stop surveyors switching.

AI transcription needs AI Transcribe on in AI Tools. Where it is off for a device, that device uses its own dictation whatever the profile says. A phone with no dictation the app can use always uses AI transcription.

Give Every Device Your AI and Weather Keys

Set your keys once for the whole organisation, then give a profile or a single device different ones where you need to. Each place has the same boxes: the AI Provider, a Google Gemini or OpenAI key, the OpenAI Model, and two OpenWeatherMap keys, one for live weather and one (Maps 2.0) for radar and cloud overlays. Leave OpenAI Model empty for Automatic, or enter the model ID OpenAI lists. Usage is billed to your own Google, OpenAI or OpenWeatherMap account.

For Every Device

In App Settings, choose Edit Organisation Keys under Organisation AI & Weather Keys, add your keys and choose Save Keys. Every device in the account uses them, whichever profile it follows.

For a Profile’s Devices

Open the profile’s AI & Weather Keys section and choose the AI Provider first: only that provider’s boxes show. Devices that follow the profile use these in place of the organisation’s. Keys saved earlier for another provider are listed apart, so you can remove them.

For One Device

Choose Device Keys beside the device under Which Profile Each Device Follows, then Save Device Keys. That device uses these ahead of its profile’s and the organisation’s.

The Organisation AI & Weather Keys card in App Settings, showing 3 keys set for every device, with the Edit Organisation Keys button ringed in red (opens full size in a new tab)
1. For every device: App Settings, then Edit Organisation Keys.
A settings profile's AI & Weather Keys section with Microsoft Foundry (your own Azure) chosen as the AI provider, ringed in red, and only Foundry's boxes below: the endpoint, a saved key shown only by its last four characters, the gpt-5-mini deployment and the gpt-4o-mini-transcribe transcription deployment (opens full size in a new tab)
2. For a profile’s devices: its AI & Weather Keys section. Only the chosen provider’s boxes show, and a saved key shows only its last four characters.
A device under Which Profile Each Device Follows with the Device Keys button ringed in red and its Keys for This Device panel open, holding a saved Gemini key (opens full size in a new tab)
3. For one device: Device Keys beside it, then Save Device Keys.

Which Key a Device Uses

Each key, the AI provider and the OpenAI model are looked up on their own, so a device can take its Gemini key from its profile and its weather key from the organisation. The first of these that sets one wins:

  1. The surveyor’s own key in the app, only if you let surveyors use their own keys.
  2. Keys for this device, set with Device Keys.
  3. The settings profile the device follows.
  4. Organisation AI & Weather Keys.

Anything none of them sets is left to the surveyor. The (i) beside each keys heading in the portal shows the same order.

The (i) beside Organisation AI & Weather Keys, ringed in red, open to show which key a device uses, in order (opens full size in a new tab)
The (i) beside a keys heading lists the same order.

Hidden and Locked on Devices

Devices use your keys in place of their own. Settings shows Set by your organisation instead of the key, and surveyors can’t see or change it. To let surveyors use a key of their own instead, tick Let surveyors use their own keys instead in Organisation AI & Weather Keys. A key a surveyor adds in Settings is then used on their device, and clearing it goes back to yours. Your keys stay hidden either way.

Never Shown Again

Once saved, the portal shows only that a key is set and its last four characters. Keys are never included in exported profile files, MDM configurations or the activity log. Paste a new key to replace one, or choose Remove Key: devices then use the next key in the order above, or their own.

Keys reach devices running version 1.7.3 or later of the PropertySurvey Pro B2B app, at their next check-in. The keys panels say how many of your devices have it.

Assign Each Device’s Surveyor

Open Devices and choose a device, or choose Assign Surveyor beside it under Which Profile Each Device Follows in App Settings. Enter the surveyor’s First Name, Last Name and Accreditations / Titles, such as RICS, RPSA, then choose Save Surveyor.

The Assigned Surveyor form for a device, with its (i) ringed in red and open, listing where the surveyor's name and accreditations come from (opens full size in a new tab)
Assigned Surveyor. The (i) shows where the app takes the surveyor’s details from.

Filled In and Locked

At its next check-in the app fills in Surveyor Name and Accreditations / Titles in Settings and on reports, and the surveyor can’t change them. Tick Let the surveyor change these in the app to fill them in once and let the surveyor correct them.

Leave Out What You Don’t Set

Leave a detail empty to let the surveyor enter their own. Remove Surveyor keeps the details on the device and unlocks them. A surveyor assigned here takes priority over a name from your MDM.

Where the Surveyor’s Details Come From

Surveyor Name and Accreditations / Titles come from the first of these that sets them:

  1. The surveyor you assign to the device here.
  2. For the name, the surveyorName your MDM sends. For accreditations, the device’s settings profile.
  3. What the surveyor typed in the app.

Assigned surveyors reach devices running version 1.7.3 or later. Devices on an older version are marked Needs the app update.

Lock Settings and Require Sections

Lock Settings on Devices

In the profile’s Lock panel, tick Lock Settings on Devices and choose a 4 to 8 digit PIN. Surveyors then need the PIN to change settings on a device that follows the profile. The portal never shows a saved PIN again, so keep it somewhere safe. To change it, type a New PIN and save.

A lock on a profile with no settings set keeps each device’s own settings as they are.

Required Sections

Under Report Sections, set Required Sections and tick the sections every report needs, such as the sign-off. Share, Email and Print stay blocked until each one is filled in, and the app lists any that are still empty. Home Survey and Commercial surveys have their own, such as a condition rating or priority for every element and the report marked Final, and each report checks only the ones it has. A hidden section can’t be required.

If you remove a profile, its devices keep their current settings and the lock it set is lifted.

Managed Devices

Send the Same Settings Through Your MDM

If you manage devices with Intune, Jamf Pro, Kandji, Workspace ONE, Google Workspace or another MDM, you can deliver a profile with the activation code. A profile saved in the portal takes priority on a device that follows one.

  1. 1

    Save the Profile in App Settings

    Create the profile as above. Only profiles with at least one setting can be added to an MDM configuration.

  2. 2

    Open the MDM Configuration

    Go to Activation Codes → QR & Setup Pack → MDM Configuration. Choose Your MDM Platform and Your Devices.

  3. 3

    Include the Profile

    Tick Include an App Settings Profile and choose the profile. If the profile locks settings, enter the same Settings PIN you saved, because the portal can’t read it back.

  4. 4

    Download and Assign

    Pick the Configuration File Format your console expects, then choose Download File or Copy Configuration. Add it as managed app configuration for the B2B app, assigned to the same devices as the app.

Managed app configuration keys for the PropertySurvey Pro B2B app.
KeyTypeValue
activationCodeStringThe activation code from your private setup pack.
settingsProfileStringOptional. The profile as one line of JSON text, from the portal’s download. The logo is left out to keep it small; devices that follow a portal profile get the logo from there. AI and weather keys never travel in it.
surveyorNameStringOptional, version 1.7.3 or later. The surveyor’s full name, usually your MDM’s variable for the assigned user’s name. A surveyor assigned in the portal takes priority.
surveyorNameLockedBooleanOptional. true stops surveyors changing the name.

Example Configurations

These show the shape only. Use the portal’s download for your real values: never type an activation code or PIN into a public document.

iPhone and iPad (app configuration dictionary for Intune, Jamf Pro, Kandji or Workspace ONE):

<dict>
  <key>activationCode</key>
  <string>YOUR-ACTIVATION-CODE</string>
  <key>settingsProfile</key>
  <string>{"format":"prosurvey-settings-profile","version":1,"app":"propertysurvey-pro","settings":{"requiredSections":["section_exec_summary","section_sign_off"]}}</string>
</dict>

Android (managed configuration, for consoles that accept JSON):

{
  "activationCode": "YOUR-ACTIVATION-CODE",
  "settingsProfile": "{\"format\":\"prosurvey-settings-profile\",\"version\":1,\"app\":\"propertysurvey-pro\",\"settings\":{\"requiredSections\":[\"section_exec_summary\",\"section_sign_off\"]}}"
}

Android Management API (an applications entry to merge into an existing policy):

{
  "applications": [
    {
      "packageName": "com.propertysurvey.pro.b2b",
      "managedConfiguration": {
        "activationCode": "YOUR-ACTIVATION-CODE",
        "settingsProfile": "{\"format\":\"prosurvey-settings-profile\",\"version\":1,\"app\":\"propertysurvey-pro\",\"settings\":{\"requiredSections\":[\"section_exec_summary\",\"section_sign_off\"]}}"
      }
    }
  ]
}

An MDM download is a snapshot. It does not change when you edit the profile, replace a code or change the PIN, so download it again and update your console after any change. Keep downloaded files private: they hold a reusable activation code, and the PIN when the profile is locked. Step-by-step console guides are in the platform guides.

Which Setting Wins

Some settings can be set in more than one place. A device takes each one from the first place in its row that sets it. The organisation always comes before a single device, and a single device before the surveyor, with one exception: keys, where a surveyor’s own key comes first only if you let surveyors use their own keys.

Where a device takes each setting from. The first place that sets it wins.
SettingWhere it comes from, in orderLocked on the device?
Which settings profileA profile that names the device, then the All Devices profile, then the settingsProfile your MDM sends. A device follows one whole profile: settings that profile leaves alone stay with the surveyor.Only with Lock Settings on Devices, which asks for your PIN.
Each AI tool on or offFor each tool on its own: AI Tools for the organisation, then AI Tools on This Device, then the surveyor’s own switches, which start on. At each, All AI Tools off turns every tool off and a tool’s own setting comes before All AI Tools on.Yes, for each tool the organisation or the device sets.
Each AI or weather key, the AI provider and the OpenAI modelThe surveyor’s own key, only if you let surveyors use their own keys. Then Device Keys, then the device’s settings profile, then Organisation AI & Weather Keys, then the surveyor’s own.Yes: shown as Set by your organisation, unless you let surveyors use their own keys.
Surveyor nameThe surveyor you assign to the device, then the surveyorName your MDM sends, then what the surveyor typed.Yes, unless you tick Let the surveyor change these in the app. For an MDM name, surveyorNameLocked decides.
Accreditations / TitlesThe surveyor you assign to the device, then the device’s settings profile, then what the surveyor typed.When you assign them, yes, unless you tick Let the surveyor change these in the app. From a profile, only with Lock Settings on Devices.
Required and hidden sectionsThe settings profile the device follows.Yes: a required section must be filled in before the report is shared, emailed or printed.

The (i) beside each heading in App Settings shows the order for that setting. Devices pick up changes at their next check-in.

Field Surveyors

What Surveyors See on Their Device

  • Settings shows that your organisation manages them, from the B2B portal or from device management.
  • Settings your organisation controls are filled in for them. If you locked them, changing a setting asks for the PIN.
  • Required sections must be filled in before a report can be shared, emailed or printed.
  • A name and accreditations you assign are filled in for them, with a note saying they were set by your organisation.
  • Your AI and weather keys show as Set by your organisation. Surveyors can’t see or change them, unless you let them use their own keys instead.
  • The microphone uses the voice input you set. With settings locked, they can’t switch it.
  • An AI tool you turn off is hidden, and its switch under AI Tools is locked with a note that your organisation set it. With every tool off, the AI keys are hidden too.
  • They still enter their own email and signature once, and those stay on their device.
PropertySurvey Pro Settings, Integrations, on a B2B device: the Gemini and OpenWeatherMap key boxes read Set by your organisation, under a note that the organisation sets them
Settings → Integrations on a surveyor’s device: your keys show as Set by your organisation.

Profiles reach devices running the current version of the PropertySurvey Pro B2B app. If a surveyor’s device seems out of date, ask them to update the app and open it while online.

If Something Does Not Work

A device has not picked up the profile

Check Which Profile Each Device Follows in App Settings to confirm the device is in the profile you expect. Then ask the surveyor to open the app while online. Make sure the app is up to date and the device is still active in Devices.

I can’t see Smart Build or AI Polish

Tick Set by Your Organisation for that box first. Smart Build only appears on boxes the app has a builder for, and view-only staff don’t see either tool.

AI Polish says the allowance is used up

The daily AI Polish allowance for your sign-in has run out. Try again tomorrow, or type the wording yourself.

AI Polish could not start

Refresh the page and sign in again if asked, then try again. If it keeps failing, contact support with the time it happened.

Can the portal set each surveyor’s name?

Yes, from version 1.7.3. Choose Assign Surveyor for the device in Devices or App Settings, enter the name and accreditations, and save. The device fills them in at its next check-in.

Can surveyors see our AI keys?

No. Devices use the keys but show only that your organisation set them, and the portal never shows a saved key again. Replace or remove a key where you set it: Organisation AI & Weather Keys, the profile or Device Keys.

A device is using a different key from the one we expected

A key set with Device Keys comes first, then the profile the device follows, then Organisation AI & Weather Keys. If you let surveyors use their own keys, a key the surveyor added in the app comes before all of them. Check each in that order, and ask the surveyor to open the app while online.

Can surveyors use their own AI key?

Yes, if you tick Let surveyors use their own keys instead in Organisation AI & Weather Keys. Devices on version 1.7.3 or later then use a key the surveyor adds in Settings in place of yours, and go back to yours if they clear it.

A surveyor still sees AI Polish after we turned it off

Check All AI Tools and AI Polish under AI Tools at the top of App Settings, then under AI Tools on This Device for that device in Devices, or beside Assign Surveyor in App Settings: the organisation’s setting wins. Then ask the surveyor to update the app and open it while online. Version 1.8.5 follows All AI Tools only, and older versions keep every tool.

Can we choose dictation or AI transcription for every surveyor?

Yes, from version 1.9.0. Open the profile’s Voice Input section, tick Set by Your Organisation, choose one and save. Lock Settings on Devices stops surveyors switching. AI transcription also needs AI Transcribe on in AI Tools.

We set settings in both the portal and our MDM

A device that follows a portal profile uses the portal profile. The MDM’s settingsProfile is used only when no portal profile applies to that device.

A surveyor forgot the PIN

Open the profile, type a New PIN and save. Devices take the new PIN the next time the app opens or checks in. Never send a PIN in the same message as the activation code.

Guidance checked 3 November 2026.

Ready to Set Up Your Devices?

Open your B2B Account to create your first profile. Start with one or two devices, check them, then add the rest.

Open B2B Account