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 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: manually adjust the mapping 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 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. You can see there 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 not reachable, too large, or 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 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”Some pipeline stages have restrictions, not every stage can be the starting stage for a new deal, and some transitions depend on the deal type.
Solution: check which stages are available for your deal type (Buy, Sell, Rent, Rent Out) on the Pipeline Stages page.
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. The Buyer / Owner toggle at the top of the Deals page determines which type of deals is visible.
Solution: toggle the Buyer/Owner switch between the two pipelines.
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 reduce the overview
- Clear the browser cache and reload
- Try a different browser (Chrome or Firefox)
I don’t see all features from the documentation
Section titled “I don’t see all features from the documentation”Features can depend on your subscription or your user role.
Solution:
- Check Settings → Subscription
- Ask an administrator if 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 the Deleted records toggle on (or similar in that view) to also see deleted records
- Clear all filters for a full overview
- Consult the Migration Verification Report that was provided with the migration
Still stuck?
Section titled “Still stuck?”Didn’t find the answer? Then contact the Tesoro team via the support option in the application.