{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-user-guide/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"redocly_category":"User Guide","type":"markdown"},"seo":{"title":"CSV Enrichment - How Matching and Match Rates Work","description":"Access documentation, use cases, and technical guides for Lusha. Learn how to query our comprehensive dataset of business profiles and company information using our three main endpoints.","siteUrl":"https://docs.lusha.com","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"csv-enrichment---how-matching-and-match-rates-work","__idx":0},"children":["CSV Enrichment - How Matching and Match Rates Work"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you upload a CSV file for enrichment, Lusha attempts to match each row to a contact or company in its database and fill in missing fields. This article explains how that matching works, what affects your match rate, and what to do when a file shows lower results than expected."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-lusha-matches-your-contacts","__idx":1},"children":["How Lusha matches your contacts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Lusha uses identity signals from the columns in your file to find matches. The more signals you include, the more accurate the match. In order of matching strength:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["LinkedIn URL"]}," — the most reliable identifier. If present, Lusha matches directly to the profile."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Email address"]}," — a strong signal for contacts already in the Lusha database."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Full name + Company name"]}," — used when LinkedIn URL and email are absent. Less precise for common names."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Full name + Company domain"]}," — similar to name + company name, with slightly higher precision."]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["💡 Tip: Including a LinkedIn URL column significantly improves match rates. Even partial URLs (e.g. linkedin.com/in/jane-doe) are accepted."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-data-lusha-adds","__idx":2},"children":["What data Lusha adds"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once a match is found, Lusha enriches the row with available data. This can include: business email, direct dial, mobile phone, job title, seniority, department, LinkedIn URL, company name, company domain, industry, employee count, and location."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"understanding-your-match-rate","__idx":3},"children":["Understanding your match rate"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After processing, your file shows two key numbers:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Scanned rows"]}," — the total number of rows Lusha attempted to match"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enriched"]}," — the number of rows where at least one new field was added"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Match rates vary based on the quality of your input data. Common reasons for a low match rate:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Missing identity fields (no LinkedIn URL, email, or company name)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Contacts not present in Lusha's database"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Stale or incorrect company names"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Personal (non-business) email addresses in the email column"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"enriched-vs-potential-enrichment","__idx":4},"children":["Enriched vs. Potential enrichment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Some rows show a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Potential enrichment"]}," count. This means Lusha identified a match but would need additional credits to reveal phone number data for those contacts. Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enrich X phones"]}," to unlock those fields using your credit balance."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"file-expiry","__idx":5},"children":["File expiry"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Enriched files are available to download for a limited time after processing. Once a file expires, the status changes to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Expired"]}," and the download is no longer available. Your results are still saved as a Workspace Table and remain accessible via ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["View table"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Now you know exactly what to include in your next upload to get the best results."]}]},"headings":[{"value":"CSV Enrichment - How Matching and Match Rates Work","id":"csv-enrichment---how-matching-and-match-rates-work","depth":1},{"value":"How Lusha matches your contacts","id":"how-lusha-matches-your-contacts","depth":2},{"value":"What data Lusha adds","id":"what-data-lusha-adds","depth":2},{"value":"Understanding your match rate","id":"understanding-your-match-rate","depth":2},{"value":"Enriched vs. Potential enrichment","id":"enriched-vs-potential-enrichment","depth":2},{"value":"File expiry","id":"file-expiry","depth":2}],"frontmatter":{"title":"CSV Enrichment - How Matching and Match Rates Work","description":"How Lusha matches contacts in your uploaded CSV file, what affects your match rate, and how to interpret enrichment results.","seo":{"title":"CSV Enrichment - How Matching and Match Rates Work"}},"lastModified":"2026-06-25T08:28:34.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/user-guide/csv-enrichment/csv-enrichment-how-matching-and-match-rates-work","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}