NZ Property Listing Fields - TradeMe Suburb and Address Guide

1. What changed

Previously, New Zealand listings used a single Suburb dropdown (from Trade Me) for all portals.

This caused issues where:

• Trade Me required a specific suburb from its own list,

• While realestate.co.nz and other portals expected the text suburb from the property's written address.

To fix this:

1. The original Suburb dropdown has been renamed TradeMe Suburb.

2. A new Suburb text field has been added.

3. If the City field is empty on a NZ listing, it now automatically pulls from the Suburb value so realestate.co.nz receives a valid suburb.

1.1. Who this applies to

• All New Zealand property listings created or edited in myatrealty.

• Agents and admins publishing to Trade Me and realestate.co.nz.

1.2. Where to find the fields

1. Open a New Zealand property in myatrealty.

2. Click the Edit icon to open the Property Edit Form.

3. Check the "Can't find address?" checkbox to reveal manual address fields.

4. In the Address Fields section you will see:

TradeMe Suburb dropdown, Suburb text field in the NZ listing screen.

1.3. How each field is used

1.4. How to fill the fields correctly (step‑by‑step)

1. Start typing the address and confirm the suggestion.

   1. Auto-populated fields: Unit, Street Number, Street Name, Postcode,
      Region, Suburb (text)

   2. Requires manual selection: District, TradeMe Suburb

   3. If everything is filled correctly stop here, if not continue.

2. In TradeMe Suburb: pick the closest matching suburb from the dropdown list required by Trade Me.

3. In Suburb (text): type the suburb exactly as you want it to appear (for example, "Milford").

4. Check Region + District: if blank, choose the correct option (for example, "Auckland").

   1. If left blank, the system will automatically use the Suburb value when exporting to realestate.co.nz | Homes for Sale, Rent, Commercial Lease and More,so the listing can still go live.

1.5. Troubleshooting – listing won't go live due to suburb

1. Check TradeMe Suburb: ensure a value is selected from the dropdown.

2. Check Suburb (text): ensure it's not empty and matches the address suburb.

3. Check City: ensure it's filled correctly, or that Suburb has a value so the system can use it for export.

4. Save the listing and try setting it live again.

If the issue continues, contact support@atrealty.com.au 

1.6. Notes & limitations

• These suburb changes apply only to New Zealand properties.

• Australian listings continue to use the existing address behaviour.

• The logic that fills City from Suburb runs only when City is empty and only for NZ listings.

2. Demo videos

2.1 Example scenarios

Scenario 1 – New NZ listing with missing suburb error

Situation: You create a new NZ listing with address "163 Ohanga Road, Onaero, New Plymouth, Taranaki 4383" from Google autocomplete.

Problem: When you try to go live, realestate.co.nz returns the error:

"The suburb code for the listing 'ListingID' is missing"

Cause: The Suburb text field is empty. Realestate.co.nz requires this field to export correctly.

Fix:

1. Open the listing and go to the Address/Location section

2. In Suburb (text field): type "Onaero" (the suburb from the address)

3. In TradeMe Suburb (dropdown): select the closest match from the Trade Me list

4. Save and set the listing live again

Result: The listing exports successfully to both Trade Me and realestate.co.nz.

Click to Watch Video

Scenario 2 – City left empty (based on previous behaviour)

Situation: You fill in the address "Suite 22, 8 Dock Street, Auckland Central, Auckland 1010"

Result when saving and exporting:

Click to Watch Video