Administration

Address Cleanup Utility

Fix duplicate house numbers in addresses caused by data entry issues

Address Cleanup Utility

The Address Cleanup utility identifies and fixes addresses where the house number has been entered twice - once in the House Number field and again at the start of Address Line 1.

The Problem

When parents or staff enter address data, they sometimes duplicate the house number:

  • House Number: 42
  • Address Line 1: 42 High Street

This results in addresses displaying as '42 42 High Street' on documents and exports.

Accessing the Utility

  1. Go to Admin > Settings
  2. Click 'Address Cleanup' in the Utilities section

Preview Mode

Before making changes, review what will be fixed:

  1. Click 'Preview Cleanup'
  2. Review the list of affected records showing:
    • Record type (Child, Parent, or Nursery)
    • Name of the record
    • Current address (before fix)
    • Proposed address (after fix)
  3. Verify the proposed changes are correct

Running the Cleanup

  1. After reviewing the preview, click 'Run Cleanup'
  2. Confirm when prompted
  3. The system removes duplicate house numbers from Address Line 1
  4. A summary shows how many records were updated

What Gets Fixed

The utility checks all address records:

  • Children - Child address records
  • Parents - Parent/guardian address records
  • Nurseries - Nursery address records

Detection Logic

An address is flagged for cleanup when:

  1. The House Number field contains a value (e.g., '42')
  2. Address Line 1 starts with the same value followed by a space (e.g., '42 High Street')

Example Fix

FieldBeforeAfter
House Number4242 (unchanged)
Address Line 142 High StreetHigh Street
Display Result42 42 High Street42 High Street

Tip: Run this utility periodically, especially after bulk data imports or at the start of a new funding period when many parent submissions are received.

Important: Always use Preview mode first to verify proposed changes. While the logic is conservative, reviewing changes prevents unexpected modifications.

Frequently Asked Questions

Is the address cleanup reversible?
No, the changes are applied directly to the database. However, the changes are logged in the audit trail. Always use Preview mode first to verify proposed changes.
Will this affect signed funding agreements?
No, signed PDF agreements are stored as documents and are not affected. Only the source address data is updated, which affects future documents and exports.
Why doesn't the preview show any records?
If no records appear in the preview, there are no addresses with duplicate house numbers detected. This is a good sign - your address data is clean!
Last updated: January 26, 2026
Was this helpful?