Skip to main content

Update an existing configuration

You can open your configuration, change its settings, or refresh it from a newer Katapult model without building a second copy by accident.

Where: web portal, Settings, then Configurations. Needs: the Org Admin role.

When you finish: you can open your configuration, change its settings, or refresh it from a newer Katapult model without building a second copy by accident.

Refresh the configuration you already run: use Edit Katapult selections, or load the model again and choose Update existing configuration. Choose Create new configuration only when you mean to build a second one. A fresh import gives you another configuration and another set of templates to tell apart when you create jobs.


What the configurations list offers

Configurations list with Enable Utility Pole Inspection and New Configuration

Control

Does

New configuration

Blank, From a Katapult model, From a KML file, From a Cloneable file

Actions on the selected configuration

Export to file, and Edit Katapult selections (only for configurations built from a Katapult model)

Enable Utility Pole Inspection, Surface Measure (beta)

Organization-wide switches, when your org has those options


Change settings on the configuration you have

  1. Open Settings, then Configurations.

  2. Open the configuration.

  3. Use the five stages for units, templates, field options, workflows and export. See Set up your configuration, stage by stage.


Updating an existing imported Katapult model

  1. Select the configuration and open its actions menu.

  2. Choose Edit Katapult selections…. The guided import reopens in update mode against this configuration.

  3. If the menu has no Edit Katapult selections…, the configuration has no stored Katapult model yet. Use the steps under When your Katapult model changes, below.

  4. Work through the steps. Step 1 shows the name, unit and ground-line checkbox greyed out; acknowledge it and move on.

  5. Finish with Update config.

When your Katapult model changes, bring the new version in without making a second configuration:

  1. Change the model in Katapult first.

  2. On Configurations, choose New configuration, then From a Katapult model. Pick your model from the Model list and choose Load model.

  3. On the Katapult model received screen, choose Update existing configuration, not Create new configuration. Pick your configuration and choose Update & rebuild. If you see Legacy configuration, this configuration has no stored model, so your selections start from scratch; choose Proceed anyway to continue.

  4. The same steps reopen with your saved choices. New fields in your model are not ticked for you, so tick the ones you want in step 3.

  5. Finish with Update config.

Stays locked

Can change

The configuration name, because existing templates carry it

Everything from step 2 onwards: elements, attributes, mappings, icons (including switching to Katapult's map style), triggers

Steps still confirm and lock in order; check before you confirm

The unit and ground-line checkbox, but in the configuration's own settings, not here


Switch an existing configuration to Katapult's map style

If your configuration was built from a Katapult model before September 30, 2026, your icons were set by hand. To bring your Katapult map across instead:

  1. Load your Katapult model again from the Model list, so Cloneable has its icons: New configuration, then From a Katapult model, then Load model.

  2. On the Katapult model received screen, choose Update existing configuration, pick this configuration, and choose Update & rebuild.

  3. At step 5, turn on Use Katapult's map style and icons.

  4. Finish with Update config.

Turning on Katapult's style replaces the icons you built by hand on these templates. If you added rules you want to keep, such as Measured, note them first and add them back on top.

Jobs already on the map pick up the new look. Nothing about your data changes, only how it is drawn.


Move a configuration to another organization

  1. In the organization that has it, select it and choose Export to file.

  2. Switch to the organization you want it in.

  3. Choose New configuration, then From a Cloneable file, and pick the file.

There is no direct organization-to-organization transfer; the file is the handoff.


Related

Did this answer your question?