Skip to main content

SmartFields in a BEP: change a project detail once

Put the client's name and other project details in a BEP as SmartFields, replace every typed copy, and change the value once for all documents.

Contents
Good to know - watch in your language: open the YouTube player settings (the gear icon), then under Subtitles/CC choose your language or use Auto-translate. If an auto-dubbed track is available, you can also switch the spoken voice under Audio track.

Who this is for

Anyone who can edit a section can insert a SmartField. Changing a SmartField's value needs Manage SmartFields on your project role. For the idea behind SmartFields, see What are SmartFields.

Why it matters

The client renames the project and you find the old name in forty places, and you only find thirty-nine. A SmartField keeps the value in one place, so every section and every document reads the same fact.


Turn typed text into a SmartField

  1. In Docs, open a section where the client's name is typed, for example Appointing party.
  2. Select the client's name in the text. The selection tools appear: AI tools, Insert SmartField and Add Comment.
  3. Choose Insert SmartField.
  4. In the list, pick Client Name. It sits in the Project Information group, because it reads straight from the project's own details.
  5. Select Save & close. The name now appears as a SmartField.
Plannerly SmartField list open in a BIM Execution Plan section, with Client Name highlighted under Project information
Select the typed name, open the SmartField list and choose Client Name.

Replace the other copies

  1. Plannerly finds the same text elsewhere and asks Replace the other matches too?
  2. Choose This document or All documents in this project. Each shows how many matches it will change.
  3. Select the Replace button, which shows the number of matches. A message confirms when it is done.
Plannerly Replace the other matches too window with All documents in this project chosen and Replace 20 matches
Choose All documents in this project, then replace every match in one go.

Change the value once

  1. Click the SmartField anywhere it appears. You do not need to open the editor.
  2. Type the new value and select Save.
  3. For a project detail such as Client Name (this needs the Manage Project Settings permission), Plannerly asks Update Client Name for the whole project? Select OK. The new name is saved in the project's details as well as in your documents.
  4. For SmartFields you created yourself, Plannerly shows "Updating this SmartField across N sections. You can keep working elsewhere." and carries on in the background.
Plannerly Exchange Information Requirements document with the updated client name highlighted in every section
Open another document and the highlighted SmartFields already show the new name.
Tip: good BEP candidates are the client's name, the project name and number, the appointing party and the key dates. Anything you would otherwise retype in a second document is worth a SmartField.
Why this matters: ISO 19650 asks for project information to be managed consistently. One value used in every document means your BEP and your exchange information requirements cannot quietly disagree.

If it doesn't work

Plannerly did not offer to replace the other matches

The offer only appears when the SmartField's value is exactly the text you selected. If the project's client name is empty, or spelt differently, there is nothing to match. Fix the client name in the project's details, then try again.

The SmartField is blank after I insert it

The project detail it reads from has not been filled in. Add the value in the project's settings, or choose a SmartField that already has a value.

Clicking the SmartField doesn't open a value box

You do not have the permission to change that value. Project details such as Client Name need Manage Project Settings; other SmartFields need Manage SmartFields. The value still shows. Ask a project manager to change it.

Some matches weren't replaced

Sections you cannot edit keep their typed text, and Plannerly tells you how many. Ask the section's owner to run the replacement again.


Common questions

How do I add the client's name to every document in a BIM execution plan?

Select the name in one section, choose Insert SmartField, pick Client Name, then replace the other matches in all documents. Any new document can use the same SmartField.

How do I change the project name in all documents at once?

Click the SmartField in any document, type the new value and save. Every section that uses it updates, in every document in the project.

What happens to sections that are already Published?

Plannerly warns you first, then moves those sections back to Shared so they can be reviewed again before republishing.

Does changing Client Name change my project settings?

Yes. Client Name is a project detail, so Plannerly asks you to confirm and updates it for the whole project.



Take the free Plannerly Essentials course - every lesson is a short video like this one, with a certificate when you finish.