Skip to main content
About

Help & support

Common questions, grouped and searchable

Have a question that’s not covered here? Send us a note.

Getting started

What Miles Mosaic is, how signup works, and what happens the first time you log in.

What is Miles Mosaic?
Miles Mosaic shows you where your elite status stands across every airline and hotel programme you track, and whether your booked trips will keep or raise it before the deadline. It tracks status and reward balances side by side, surfaces what is expiring, and helps you plan your next move, all without a loyalty password.
How do I create an account?
Use the registration page to sign up with an email and password, or use Google or Microsoft sign-in if that is easier. After verifying your email you are walked through a short onboarding flow that asks which programmes you already hold and your current tiers, so the dashboard has something to show on day one.
Is there a free plan?
Yes. Explorer is the free tier and gives you the core dashboard, recent activity views, your full loyalty portfolio, basic elite-progress visibility, and one actively-monitored airline programme plus one hotel programme. Pro turns on full active monitoring across every programme you connect, the Reward Miles valuation dashboard, the Trip planner, Smart Upload for PDF / image / email parsing, and broader expiry alerts. See the pricing page for the live list.
Do I need to connect my airline, hotel, or bank accounts?
No. Miles Mosaic is built around user-controlled inputs. You add the programmes, balances, flights, stays, and notes you care about; the product does not require bank credentials or loyalty-account passwords to be useful, and we will never request them.
What happens on my first login?
You land on the dashboard and a short guided tour starts automatically, pointing out the four panels (loyalty progress, flights, stays, recent activity) and where to add your first programme. As you visit other pages (Programmes, Add Programme, Programme detail, My Flights, My Stays, the Trips page, the Map, and the Add Flight / Add Stay / Plan Trip / Smart Upload / Smart Inbox drawers), a one-time tour fires there too. You can close any tour with the X, Escape, or by clicking outside it.
How do I replay a tour, or get help on the current page?
Click your avatar in the top-right and choose Take page tour. The item is disabled when no tour is registered for the current page and active (labelled Start) when one is available. If you closed the tours and changed your mind, that menu still replays them on any page that has a tour.
Can I keep using Miles Mosaic on mobile?
Yes. Miles Mosaic ships with a web-app manifest and a service worker, so the site behaves like an installable app on supported devices. Use it in the browser, or add it to your home screen for faster repeat access. There is no separate native app to download.

Your dashboard, navigation & Atlas

How to find what you need, what each section is for, and how to talk to Atlas, the in-app AI assistant.

What do the four dashboard panels show me?
The Loyalty progress panel summarises your top programmes and flags any that are behind tier pace or have expiring balances; toggle between Status and Rewards views. The Flights panel shows your next departure and YTD totals. The Stays panel shows your next stay and YTD nights. The Recent activity list shows the last flights and stays we have logged.
How is the navigation organised?
The top bar has five primary destinations: Main (dashboard, trips, map, activity), Trips (shortcut into Main → Trips), Flights (dashboard and My Flights), Stays (dashboard and My Stays), and Loyalty (programmes dashboard, Add Programme, plus optional power-user tools like Reward Miles or the Tier Simulator if your plan exposes them). The avatar on the right opens your profile menu: My Profile, Plan & billing, Programmes, Preferences (when enabled for your account), Referrals (when enabled), Take page tour, and Help & shortcuts. The orange + Add button reveals quick-add drawers: Add Flight, Add Stay, Plan Trip, Smart Upload, Smart Inbox.
What is Atlas?
Atlas is the in-app AI travel-loyalty assistant. Click the Atlas Spotlight pill at the top-right of any authenticated page (or press ⌘K / Ctrl+K) to open Spotlight; deeper conversations slide out in the right-rail SidePanel. Ask questions like "what is my best redemption with Avios right now?", "should I run a status mattress run this year?" or "summarise where my AAdvantage account stands today". Atlas reads your own data (programmes, balances, flights, stays, trips) and shapes its answer around it. Atlas never reads files from your computer and never sends your data to third-party advertisers.
What are the Atlas chip suggestions on each page?
Many pages surface two or three suggested prompts as orange chips above the main content. Tap a chip and Atlas opens with that question pre-filled. The chip suggestions are tailored to the page context (programme-focused on Loyalty, trip-focused on Trips, planning prompts in the planning context), so they nudge you toward the next useful question without you having to think it up.
How do I find a specific page or feature?
Use the search icon in the top bar (magnifying glass) to open the global search, then type the page name or any programme / airport / hotel that matches. The search jumps directly to the right surface inside the app.

Tracking flights & stays

Adding, editing, and reviewing the activity that drives every other number in Miles Mosaic.

How do I add a flight?
Click + Add → Add flight in the top bar (or the matching button on Flights → My Flights). The drawer is a two-step wizard: step 1 takes the date and flight number, and Atlas looks up the carrier, airports, distance, and aircraft. Step 2 lets you confirm cabin, route, and which programme to credit. Mark the flight as completed if it has already flown. Pending-credit flights still show in your list so you can track them.
How do I add a hotel stay?
Click + Add → Add stay (or the matching button on Stays → My Stays). Start typing the hotel name: we search your previous stays, our shared cache, then Google Places, and auto-fill the address and coordinates. Step 2 captures check-in, check-out, nights, and the loyalty programme.
What is the difference between Flights → Dashboard and Flights → My Flights?
The Dashboard view summarises stats: segments, distance, alliance and cabin mix, year-over-year change. The My Flights view is the full list of every segment you have logged, with filters (year, cabin, airline, route) and per-row edit / reassign / mark-completed actions. The Stays section mirrors the same split: Dashboard for stats, My Stays for the full list.
How do I edit or delete a flight or stay?
On My Flights or My Stays, click a row to open the editor in a side drawer. The form lives inside the drawer; close it with the X or Escape when done. Delete is on the editor: soft-deleted items can be recovered from Profile → Account → Trash before they purge.
Why is a flight or stay marked “pending tier credit”?
A flight or stay you have logged but not yet marked as completed shows in the pending bucket. Once you tick mark as completed on the row (or on the editor), the activity counts toward your tier progress and reward miles balance. This separation lets you log future-dated trips without distorting your current-year totals.
How do I filter or bulk-update my list?
Click Filter on My Flights or My Stays to narrow by year, cabin / chain, airline / region, and route / city. Filters survive page navigation. Use the row checkboxes to select multiple rows; the bulk bar at the bottom appears with Cancel, Mark completed, Assign programme, and Delete actions.

Loyalty programmes

How the loyalty portfolio works: connecting programmes, tier progress, expiry, and the per-programme detail page.

How do I connect a new loyalty programme?
Go to Loyalty → Add Programme (or click the orange + Add Programme button in your portfolio). Miles Mosaic never connects to programmes by API or scraping. You pick the airline or hotel, type your current balance, set the tier you hold today (leave it on no tier yet if you are starting out), and optionally enter your membership number. We pre-load programme rules (earn rates, expiry, status thresholds) for the major airline and hotel programmes, so once your balance is in, the projections appear immediately.
What can I see on a single programme’s detail page?
Click any programme card from Loyalty → Dashboard to open its detail page. You see the hero (balance, tier, distance to next tier), a tier-progress panel that uses the programme’s own qualification rules, expiry timing for the balance, and the recent flights or stays that earned credit for that programme. The Open full detail button takes you to the legacy editor for membership-number / expiry / status-level edits.
What is the difference between airline, hotel, and transferable programmes?
Airlines and hotels are direct programmes: your balance lives with them and is earned from flights or stays. Transferable programmes (Amex Membership Rewards, Chase Ultimate Rewards, Capital One Miles, Bilt, etc.) sit on top: their points transfer into the airline or hotel partner you nominate. They appear in a third section on the Loyalty → Dashboard so you can see them alongside your direct balances.
How do tier progress and pace work?
Each programme has its own qualification ladder (Premier Silver, Platinum, 1K; Bonvoy Silver, Gold, Platinum; etc.). We track miles, segments, nights, or spend depending on the programme’s actual rules. The pace label (On track, At risk, Behind, Achieved) compares your current progress to how far through the qualification year you are, so by mid-year you should be 50% to your target tier to be on track.
Can Miles Mosaic warn me about expiring balances?
Yes. Expiry monitoring is built into the alerting system. Explorer defaults to a lighter reminder set (30 days); Pro can use broader lead windows (90 / 30 / 7 days) and adds status-deadline and activity-required alerts. The Loyalty → Dashboard also surfaces expiring balances and status deadlines inline.
How do I update my balance or tier when it changes?
On the Loyalty → Dashboard, click the Adjust button on the programme card to set a new balance. For tier updates, open the programme detail page and use Open full detail. We do not auto-pull balances; the programme of record is whatever you last typed in plus the activity you have logged since.
What is the Reward Miles page?
Reward Miles is a Pro-only view that values each mile and point in cash by tracking your actual redemptions. It surfaces three views: Redemption value (cents/point you have actually realised), Card-cost tracker (annual fees vs miles earned per card), and a year-over-year trend. Explorer sees a teaser; Pro unlocks the live valuation dashboard.

Trips, maps & quick-add tools

Group activity into named trips, see it on a world map, and add things fast with Smart Upload and Smart Inbox.

How do I plan a trip?
Click + Add → Plan a trip (or the Plan a trip button on the Trips page). The drawer lets you name the trip (leave it blank to auto-generate from the itinerary), pick a primary purpose, and add flight and stay segments. Toggle Quick mode to keep each row to the essentials, or off for full per-segment detail. Save when ready; the trip appears on the Trips page and the segments are linked back to your flight / stay history.
What is the Trips page for?
Trips groups your flights and stays into named journeys with one date range and one primary purpose. The page splits into Upcoming (sorted by how soon they start) and Completed. Each card shows flights and stays counted, total nights, time-until-departure, and quick actions to share (copy a plain-text summary) or delete.
How do I see my travel on a world map?
Go to Main → Map. Every flight you have logged is plotted as a great-circle path; every stay is plotted as a pin. Use the toolbar to filter by date range, switch between flights / stays / both, or aggregate hotels into a city-cluster view. Click a flight or airport marker to see airport, city, and country details; click a stay pin to see hotel name, location, and date details.
How do I share a trip itinerary?
On the Trips page, hover the trip you want to share and click the share icon: the Share trip drawer opens with a clean plain-text summary of your itinerary (segments, dates, programmes). Copy it into a message, email, or chat with one click. Private share links are a planned enhancement.
How does Smart Upload work?
Smart Upload is the + Add → Smart Upload drawer. Drop a boarding pass, e-ticket PDF, hotel folio, screenshot, or itinerary export onto the drop zone, or click to browse. Supported formats: PDF, PNG, JPG, JPEG, CSV, XLSX, XLS, and DOCX. OCR / parsing extracts the fields in a few seconds and shows them to you to confirm before saving. Uploaded files are kept in your upload history so you can re-review them. Quotas: Explorer is capped at three uploads per month; Pro raises the limit (default 50 per month, see Plan & billing for your tier’s exact quota).
What is Smart Inbox?
Smart Inbox is the Pro-only + Add → Smart Inbox drawer for reviewing forwarded travel emails such as boarding passes, hotel confirmations, and transfer-bonus offers. The drawer and inbox API exist, but the current list / review / import wiring is still incomplete, so it is not a dependable end-to-end import path yet. For now, use Smart Upload as the working path: drop a PDF, screenshot, or spreadsheet export of the same booking and confirm the extracted fields.
How do I bulk-import historical data?
Use Smart Upload with a CSV or spreadsheet (XLSX / XLS). Drop the file into the drop zone, map the columns to flight / stay fields when prompted, and confirm. The bulk path counts against the same monthly quota as single-document uploads (Explorer three; Pro default 50, your exact quota is on Plan & billing). If you are migrating from another tracker and have a large backlog, contact us and we can advise on the cleanest column layout.
Is there a Year in Review?
Yes, for Pro users. Once a calendar year closes (or near year-end), Main → Year in Review compiles your flights, stays, programmes, miles earned, top destinations, and a few "where did the year actually go" charts. Explorer users see the headline summary; Pro unlocks the full deck.

Pro plan, billing & your profile

Pricing, cancellation, refunds, profile preferences, and what each Profile section is for.

How much does Pro cost?
Pro is currently $14.99 per month, with a discounted yearly option. The live price (and any country-specific tax adjustments) appears at checkout. Prices are inclusive of any VAT that applies in your country; the breakdown shows on the receipt. Explorer remains free. The live source of truth is the pricing page.
What do I get with Pro that Explorer does not have?
Pro turns on active monitoring on every programme (Explorer is capped to one airline + one hotel actively monitored), unlocks the Reward Miles valuation dashboard, the Trip planner, Smart Upload for PDF / image / email (CSV stays on Explorer), Year in Review, broader expiry & status alerts, and removes ads. Explorer keeps the core tracker: dashboard, programme portfolio, my flights / stays lists, the manual Add flows.
How do I upgrade to Pro?
Go to Profile → Plan & billing from the avatar menu, or click the orange Upgrade to Pro button anywhere you see a Pro-locked panel. Payment is handled through Paddle Checkout: the live checkout shows the methods available in your country.
How do I cancel Pro?
Cancel from Profile → Plan & billing, or write to billing@milesmosaic.com. You keep Pro features until the end of the current paid period and no further charge is made. Your data, programmes, and history stay intact. You drop back to Explorer limits.
Do you offer refunds?
The terms are explicit: subscription fees are billed in advance and are non-refundable. That applies to unused time, downgrades, and partial periods. Read the terms of service before purchasing if refund flexibility matters to you.
What lives in the Profile section?
Account: name, email, password, two-factor, theme, currency, plus tabs for Export (download your data) and Trash (recover soft-deleted flights and stays). Plan & billing: upgrade, downgrade, cancel, invoices. Loyalty memberships: manage every programme you have connected and their tier history. Preferences (if your account has it enabled): alert lead times, notification channels, what to show on the dashboard. Referrals (if enabled): your referral link, who has signed up, rewards earned. Atlas actions: every action Atlas has taken on your behalf, newest first; supported actions can be undone within their short undo window, after which the change is locked in.
I forgot my password.
Use the ‘Forgot your password?’ link on the login page. We email a time-limited reset link to the address on file. If you originally signed in with Google or Microsoft, use the matching ‘Continue with…’ button instead of a password reset.

Privacy, data & corrections

What we collect, what we deliberately do not, and how to get your data out (or delete it entirely).

What data does Miles Mosaic collect?
The minimum we need to run the tracker. Account fields, the programme balances and travel activity you type in, optional payment metadata when you upgrade, and the technical access logs needed for security. We never store loyalty-programme passwords. Full detail in the Privacy Policy.
Does Miles Mosaic sell my data?
No. We never sell, rent, or share personal data with marketing brokers, data brokers, list resellers, or advertisers. We also do not maintain any ‘audience segment’ product. The full list of what we do not do is in section 3 of the Privacy Policy.
How do I export my data?
Go to Profile → Account → Export. The export downloads immediately as a ZIP containing every programme, balance, flight, stay, and trip you have entered. Your Atlas action history has its own CSV export from Profile → Atlas Actions. Both downloads happen in your browser; nothing is emailed.
How do I delete my account?
Contact us to request account deletion: we will action it manually under our Privacy Policy, including any billing-record retention or full data-erasure questions. The current Profile → Account controls do not provide a reliable self-serve account-deletion path; the visible delete card opens subscription cancellation. In the meantime, the contact route is the reliable way to make sure every record is handled correctly.
How is Miles Mosaic editorial funded?
Three sources: reader subscriptions (Pro), display advertising on the Explorer tier (Google AdSense, with clearly labelled placements), and a small affiliate revenue line on credit-card and shopping-portal links. Articles containing affiliate links carry an above-the-fold banner. Full disclosure in our affiliate disclosure and editorial policy.
How do I report a factual error in an article or in the app?
Use the contact form. Verified corrections to articles are added to the bottom of the affected article with the date, what changed, and why, and logged on the corrections page. App-side bug reports go to the same form; include the page you were on, the programme involved if any, and a short reproduction with a screenshot so we can investigate without guesswork.

Still stuck?

Use the contact form and we’ll answer within two business days, usually much sooner. Include the programme name, the page you were on, and a short reproduction if you can.