General information on the topic of structured addresses can be found here: Structured addresses in bexio
Since July 2025, your contacts can be saved using a structured address format. This new format involves the separation of the street name, street number, and addition address fields, and it is applicable when creating or modifying all your contacts.
ℹ️ Considering the quantity of addresses requiring structuring, bexio has made a massmutation tool available now. Further details can be found in the section below: How to Split All Addresses
If the contact's address is not structured, the address in the QR code under "Payable by" may be left blank. Your end customer can still pay the invoice, but they must ensure that the address is entered correctly when the payment is recorded. For this reason, it is worth structuring the addresses in bexio so that the information is complete again.
Content
1. How to update the addresses of new and existing contacts.
2. How to Split All Addresses
2.1 Explanatory video: Mass mutation - structured addresses
3. Do you need help migrating your contacts (structured addresses) ?
1. How to update the addresses of new and existing contacts.
Main addresses
The street name and house number fields have been separated for both the main contact and for additional addresses.
When you edit an existing contact, we'll try to structure the address for you. If bexio's suggestion works for you, just save the contact to structure the address. Otherwise, you can overwrite bexio's suggestion and then save it.
Once the contact is successfully structured, the blue message won't appear anymore when you edit the contact again.
Additionally, the Address addition field is now available, allowing you to add further information to the address.
Additional Addresses
We have also made adjustments to additional addresses.
2. How to Split All Addresses
Step 1: Access to the contact tab
Go to the "Contact" tab Click the 3 horizontal dots > split addresses
Step 2: Start the split addresses process
As soon as you click on the "Split addresses" button. A new page will open to present you with the information about the structured addresses.
Step 3: Select the contacts to be structured 1. A drop-down list will display all the contacts you need to structure.
⚠️ Be sure to check each address before selecting the checkbox to prevent blindly splitting all addresses.
2. Select all contacts by clicking the selection box. Once selected, you can proceed to approve all the contacts.
Structuring main and additional addresses
You can structure all contacts in a single batch, subject to the following points:
500 Contact Limit: It is important to note that there is a limit of 500 contacts that can be processed at once. If you have more contacts, you must divide your process into multiple steps.
Error Management: The system will automatically ignore contacts displaying a danger symbol (alert icon). These addresses don't comply with the standards and are not accepted as valid addresses; they must be corrected manually beforehand (see Step 4 for correction details).
Step 4: Error Handling: Warning/Danger Symbol
If a contact has an alert symbol (usually an icon indicating an error), this means that the address doesn't comply with the standards defined in the system.
This can happen if certain information is missing or not taken into account:
Required fields: address, postcode, city or country (even if the country is missing).Countries considered: Germany, Switzerland, Austria, Italy, Great Britain, Liechtenstein, France.In order to rectify the main or supplementary addresses displaying this danger symbol:1. Click on "Edit " next to the address.
2. Manually add the street name and street number.
3. Click ‘Save’ to save the change. The address will then be updated and you can structure it correctly.
2.1 Explanatory Video: Mass mutation - structured addresses
VIDEO
3. Do you need help migrating your contacts (structured addresses) ?
To facilitate your transition to the new structured format, we offer to handle the migration and splitting of all your existing addresses .
The "Basic " option provides support for migrating up to 1,000 contact addresses. The "Advanced " option provides support between 1,000 and 5,000 contact addresses. We remind you that you remain solely responsible for the accuracy and completeness of your contact data . We can only guarantee correct structuring if the basic information (addresses and contact details) you provide us with is accurate. Consequently, we decline all responsibility for errors resulting from inaccurate or incomplete source information.