Syncing Your Favorites

Save your favorite properties and access them from any device—no passwords required.

Quick Start

Browse properties on any device and click the heart icon to save favorites
Save 3+ properties and you’ll see the sync prompt appear
Enter your email to receive a magic link
Click the link to verify your email and sync favorites across devices
Access anywhere — your favorites are now linked to your email

Saving Properties

Click the heart icon on any property card or detail page to save it:

Search results — Heart icon in top-right of each card
Property details — “Save Property” button below images
Map view — Heart icon on property popups

Setting Up Sync

When you’ve saved 3 or more properties, a sync prompt appears on the favorites page:

Enter your email address
Click Sync
Check your inbox for the magic link email
Click the link to verify and sync

What the Magic Link Email Looks Like

Subject: Sync your saved properties - [Brokerage Name]

Click the button below to sync your saved properties across all your devices.

[Sync My Favorites]

This link expires in 15 minutes.

After Syncing

Once verified, you’ll see:

“Synced as [your email]” status on the favorites page
Your favorites count displayed in the navigation
A Sign out button to disconnect

Adding More Favorites

After syncing, any new favorites you add are automatically saved to your account—no need to sync again! Just click the heart icon and the property is instantly synced.

Accessing from Another Device

To see your favorites on a different device:

Go to /favorites on the new device
Enter the same email you used before
Click the magic link sent to your email
Your favorites appear immediately

Sign Out

Click Sign out to disconnect your email. Your favorites remain on your current device but won’t sync to others until you sign in again.

Troubleshooting

Magic Link Expired

Problem: Clicked the link but it says “expired”

Solution: Links expire after 15 minutes for security. Go to /favorites and request a new one.

Didn’t Receive the Email

Problem: No magic link email in inbox

Solutions:

Check spam/junk folder — Sometimes email filters catch magic links
Verify email address — Make sure you entered it correctly
Wait a minute — Email delivery can take 30-60 seconds
Try again — You can request up to 3 links per 15 minutes

Favorites Not Showing on New Device

Problem: Logged in on new device but favorites don’t appear

Solution:

Verify you’re using the exact same email as the original device
Check that you clicked the magic link (not just entered email)
Refresh the favorites page after clicking the link
If still not showing, try clearing browser cache and signing in again

Lost Access to Email

Problem: Can’t access the email address you used

Solution: Unfortunately, favorites are tied to the email address. Without access to the email, you cannot sync those favorites. You can:

Save favorites locally on your current device (no sync needed)
Start fresh with a new email address
Contact support if you need to transfer favorites to a new email

Favorites Disappeared

Problem: Favorites were there, now they’re gone

Possible causes:

Cleared browser data — Favorites are stored in localStorage, which is cleared when you clear browsing data
Different browser/device — Favorites don’t sync unless you’ve signed in with your email
Signed out — Signing out disconnects sync but shouldn’t delete local favorites

Solution: Sign back in with your email to restore synced favorites.

Privacy & Data

Local First

Favorites are always stored on your device, with optional cloud sync.

Email Only

We only use your email for syncing—no marketing without consent.

Your Data

Remove individual favorites anytime, or sign out to disconnect.

What Data is Stored

When you sync favorites:

Data	Purpose	Storage
Email address	Identify your account across devices	Server
Listing IDs	Track which properties you’ve saved	Server
JWT token	Authenticate API requests	Browser localStorage
Verified flag	Confirm email ownership	Server

Removing Data

To remove favorites data:

Individual favorites — Click the heart icon again to unsave
All favorites — Click “Clear all favorites” on /favorites
Account disconnection — Click “Sign out” to stop syncing
Complete deletion — Contact support to delete server-side data

Advanced Usage

Custom Events (For Developers)

Listen for favorites changes in your application:

// Listen for favorites changes
window.addEventListener('favoritesChanged', (e) => {
  console.log('Favorites updated:', e.detail);
});

// Listen for auth state changes
window.addEventListener('authChanged', (e) => {
  console.log('Auth state:', e.detail.authenticated);
});

LocalStorage Keys

Favorites use these localStorage keys:

Key	Purpose
`idx_favorites`	Array of listing IDs
`idx_auth_token`	JWT for API authentication
`idx_auth_email`	User’s verified email

Best Practices

For Visitors

Sync early — Don’t wait until you have 20 favorites to sync
Use the same email — Consistency across devices is important
Don’t clear browser data — This removes local favorites
Check spam — Magic links sometimes get filtered

For Brokerages

Encourage sync — Higher engagement when favorites are accessible everywhere
Monitor magic link delivery — Ensure email service is working
Respect unsubscribes — Don’t use sync emails for marketing
Track conversion — Favorites sync often precedes serious buying intent

Passwordless Authentication — Learn why magic links are better than passwords
Favorites API — Technical API documentation
Property Alerts — Get notified when prices drop on favorites
Saved Searches — Save search criteria for quick access