Troubleshooting: quickly find a solution
Go directly to the most common problems. Find the symptom that matches your situation, each solution is in 1-3 sentences.
Jump to your topic
Section titled “Jump to your topic”| Topic | Common symptoms |
|---|---|
| Importing | CSV fails, rows are skipped, field mapping is incorrect |
| Properties | XML feed not syncing, properties disappear, photos invisible |
| Communication | Emails are not sent, WhatsApp not arriving |
| Client Portal | Client cannot log in, client sees no properties |
| Deals & pipeline | Stage move blocked, deals invisible in board |
| General | Slow interface, missing features, data after migration |
Importing
Section titled “Importing”My CSV import fails completely
Section titled “My CSV import fails completely”The file is not a valid CSV, is missing a header row, or is not UTF-8.
Solution:
- The file must end with
.csv - The first row must contain column headers (
first_name,email, …) - Save it as UTF-8 CSV (in Excel: Save As → CSV UTF-8 (comma delimited))
- Or: download the sample file from Tesoro and use it as a template
Some rows are skipped
Section titled “Some rows are skipped”Required fields are empty, invalid email format, or unknown value for type/status.
Solution: check the import log, each skipped row shows a specific error. Most common:
| Error message | What it means |
|---|---|
| “First Name cannot be blank” | First name missing |
| “Email is not a valid email address” | Typo in email address |
| “Owner email not found” | owner_email refers to a team member that does not exist |
The field mapping is incorrect after upload
Section titled “The field mapping is incorrect after upload”Your column headers do not match Tesoro field names.
Solution: adjust the mapping manually in step 2 of the import process. Or use exactly the column names from the sample file for automatic mapping.
Multiple values in one field are not recognized
Section titled “Multiple values in one field are not recognized”Fields like property_details.type only accept multiple values with commas as delimiter.
Solution:
- ✅
apartment, villa, townhouse - ❌
apartment; villa; townhouse
Phone numbers are not saved correctly
Section titled “Phone numbers are not saved correctly”Spaces are automatically removed, but parentheses and dashes cause issues.
Solution: use international E.164 format without special characters:
- ✅
+31612345678 - ❌
+31 (6) 1234-5678
Properties
Section titled “Properties”XML feed is not synchronizing
Section titled “XML feed is not synchronizing”Feed URL unreachable, not valid Kyero format, or the import is not active.
Solution:
- Open the feed URL in your browser to check availability
- Verify that the XML is valid Kyero format
- Go to Settings → XML Import and set the import to active
- Click Trigger Manually to start manually and view any error messages
Properties disappear after XML sync
Section titled “Properties disappear after XML sync”Tesoro can automatically mark properties that are no longer in the feed as deleted. This depends on the Remove Property Status setting in the XML import.
Solution: check that setting on the import page. There you can see which properties are marked for deletion before the actual deletion takes place.
Photos are not displayed
Section titled “Photos are not displayed”Image URLs in the feed are unreachable, too large, or in an unsupported format.
Solution: test the URLs directly in your browser. If the URLs are correct but photos do not load, contact the Tesoro team.
Communication
Section titled “Communication”Emails are not sent
Section titled “Emails are not sent”Email integration incorrectly configured, invalid recipient address, or error in the template.
Solution:
- Check Settings → Personal Settings → Email (your integration)
- Verify the recipient’s email address
- Send a test email to validate the configuration
- Check your template for missing variables or typos
WhatsApp messages are not arriving
Section titled “WhatsApp messages are not arriving”Phone number not in international format.
Solution: WhatsApp requires E.164 with country code. Update your contact’s phone number to +31612345678 format.
Client Portal
Section titled “Client Portal”Client cannot log in
Section titled “Client cannot log in”No invitation received, password incorrect or expired, or portal access not activated.
Solution:
- Open the client’s contact page, has an invitation been sent?
- Send a new invitation or a password reset
- Check if the client portal is activated in your subscription
Client sees no properties in the portal
Section titled “Client sees no properties in the portal”No properties shared with this client, or the shared properties do not have the status Active.
Solution: open the contact page, check which properties are shared. Ensure those properties have the status Active (shared Drafts are invisible in the portal).
Deals & pipeline
Section titled “Deals & pipeline”I cannot move a deal to a specific stage
Section titled “I cannot move a deal to a specific stage”A stage with Commits the property locks the property. Tesoro refuses that step if another deal has already claimed the same property, or if a Buy or Rent deal does not yet have a property on Approved.
Solution: read the message Tesoro displays, and see Setting Up Pipelines and Pipeline Stages.
Deals do not appear in the board view
Section titled “Deals do not appear in the board view”You are looking at the wrong pipeline. At the top of the deal board, two choices determine which deals are visible: the BUYER / OWNER toggle and, next to it, the pipeline selector.
Solution: choose BUYER or OWNER and then the correct pipeline, or All pipelines to see all deals on that side per stage. See Pipeline Stages.
General
Section titled “General”The interface loads slowly
Section titled “The interface loads slowly”Slow connection, too many records loaded at once, or full browser cache.
Solution:
- Test your internet connection
- Use filters to make the overview smaller
- Clear the browser cache and reload
- Try a different browser (Chrome or Firefox)
I do not see all features from the documentation
Section titled “I do not see all features from the documentation”Features may depend on your subscription or your user role.
Solution:
- Check Settings → Subscription
- Ask an administrator whether you have the right permissions
- An Employee sees less than an Admin
Data is missing after migration
Section titled “Data is missing after migration”Deleted records are often imported with is_deleted: true and are hidden by default. Or: active filters hide records.
Solution:
- Turn on the Deleted records toggle (or similar in that overview) to also see deleted records
- Clear all filters for a complete overview
- Consult the Migration Verification Report that was delivered with the migration
Still stuck?
Section titled “Still stuck?”Did not find the answer? Then contact the Tesoro team via the support option in the application.

