All articles
List & Data Sources

Upload people, companies, and job titles via XLSX

Upload an Excel file (XLSX) when you already know which people, companies, or job titles you want. Signalist matches each row, enriches it, and scores the leads. A clean file and the right upload type make the difference between a useful list and a lot of "Not found".

Choose the upload type

Click Create new list, choose Upload & webhook, and pick the tile that matches your data:

TileUse it when you haveMinimum columns
Upload a list of peopleSpecific people you want to reach.A personal LinkedIn URL, or a first and last name (or full name) together with the company name, website, or LinkedIn page.
Upload a list of companiesTarget companies; Signalist finds the right people there.The company name, website, or LinkedIn page.
Upload a list of job titlesTarget roles at known companies.The job title together with the company name, website, or LinkedIn page.

Optional columns help with matching: email address, job title, company country, or personal country.

The Create new list page with the Upload & webhook category.

Prepare the file

  • Only .xlsx files are accepted, and only the first sheet is read.
  • Use one header row and one row per person or company.
  • Keep one kind of value per column, and use plain values instead of formulas.
  • Prefer the company website or LinkedIn page when company names are ambiguous.
  • Leave out anything Signalist does not need, such as internal notes.

An example XLSX file with one header row and separate columns for name, company, job title, website, and LinkedIn URL.

Upload and map the columns

  1. In the source step, click Upload an XLSX file and drop the file in, or choose it. The list is named after the file; you can change the name.
  2. Signalist analyses your columns and suggests a mapping. Check every column: map it to a Signalist field, choose Save as Custom Field to keep it, or Do Not import.
  3. Upload stays greyed out until one of the minimum combinations above is mapped.
  4. Preview shows how the first rows will look in Signalist. It does not run anything yet.

The source step of an XLSX upload with the file upload and column mapping.

After the upload, Signalist shows statistics: rows detected, rows ready to process, duplicates in the file, and, for company lists, how many companies are already known.

Company lists: people per company and preview

For a company list, choose under People per company how many people Signalist should find at each company (1 to 3). It costs 1 credit per company, whether or not a person is found, plus 1 credit for each additional person.

Start Preview tries the search on a sample of companies first. It shows who was Found, Unsure, Not Found, or Skipped, the Credits used, and the Est. full list credits. Re-run Preview lets you keep the leads already found or start over.

Company lists: use your contacts first, or find new people only

Your workspace may already hold people at the companies on your list: leads from other lists, contacts you uploaded, or your LinkedIn connections. Under Who should we find? you decide whether Signalist may use them:

OptionWhat happens
Use my contacts first (default)People already in your Contacts at the company are used first, at no cost while their data is recent. New people are searched only for the places left. This is how the list run works. In a bulk Find person run from the Companies tab, a reused contact is charged like a found person.
Find new people onlyNobody already in your Contacts is added. Signalist leaves your contacts out before any person is paid for, so the places under People per company go to new people.

The choice "Who should we find?" with the options "Use my contacts first" (default) and "Find new people only".

The choice is in the list's Find person step and in its Settings step; both change the same setting. It is offered on company uploads and on the other lists that search for people at their companies, such as Google Maps, job, funding, and AI company search lists that are set to find people. On these lists it replaces the switch Only add new leads that have not been added to other lists before: every lead of your lists is also in your Contacts, so Find new people only keeps those people out too.

With Find new people only:

  • "Your Contacts" means everyone you can see under Contacts → Contacts: leads from your lists, contacts you uploaded, and LinkedIn connections.
  • Signalist recognises a contact by name and by LinkedIn profile. A new person with exactly the same name as one of your contacts at that company is treated as that contact.
  • If everyone found at a company is already one of your contacts, the list shows the reason No new person among the top matches for that company under Not found, instead of a plain "not found".
  • A person left out because they are already a contact is never charged. Each company searched costs 1 credit, as with any search.

A change applies to the searches that run after it, including a re-run of the list.

Company lists: enrich companies first, find people later

By default, Signalist searches for people at each company as soon as the company is added. If you want to review the companies first and pay for people only at the companies you pick, choose this in the list's Find person step, under When should we search for people?:

OptionWhat happens
Find people now (default)Each qualifying company is searched with your search profiles as soon as it is added.
Only enrich companies, find people laterCompanies are enriched, qualified, and scored, but nobody is searched yet. Nothing is charged for finding people while the list runs.

The Find person step with the choice "When should we search for people?" and the option "Only enrich companies, find people later" selected.

The choice is offered for Upload a list of companies, Request us to scrape a list of companies, and for the lists that look for companies first and then find people at them: Import Google Maps, Track startup funding rounds, Track Mergers & Acquisitions, Find companies with natural language, and Monitor company news and announcements. It is not offered for Find companies that are hiring: those lists still search for people as each company is added. You still set up at least one search profile and People per company: they are the defaults when you search later. Start Preview still runs a real search on a sample and is charged as usual.

On a Google Maps, funding, M&A, or company news list, each company added to the Companies tab counts toward the list's lead limit, so the limit also caps a run in this mode.

The Companies tab

In this mode, the companies appear on the list's Companies tab, after Ignored. Each row shows the company's score, segment, number of employees, and country. The People column tells you whether anyone has been searched:

  • No person searched yet, with a Find person link
  • Searching for people…
  • the people found, for example 2 people · in New
  • No person found at the company, with the date of the search
  • Didn't fit the ICP filter · not searched
  • Blacklisted

Filter the tab by these states with Show. The companies on this tab are not leads: they do not appear on New and are not counted as not found. They also stay on the tab until you search them; they are not moved to Ignored over time.

Find people at the companies you pick

  1. On the Companies tab, select companies with their checkboxes, or click Find person in a single row.
  2. Click Find person in the bar at the bottom.
  3. The window Find people at N selected companies is pre-filled with the list's search profiles. Change them for this run, pick a saved preset, or change how many people to find per company. Who should we find? starts with the list's choice; a change there applies to this run only, and the list keeps its own setting.
  4. Check the cost before you start: 1 credit per company searched, whether or not someone is found, and 1 more credit for each additional person. With Use my contacts first, a contact reused here is charged like a found person. Email and phone lookups for the people found follow the list's settings; the window lists them with their cost.
  5. Click Find people at N companies. Each row updates when its company has been searched, usually within a few minutes. The people found are added to New and shown on their company's row.

The Companies tab of a list with two companies selected and the Find person button in the bar at the bottom.

Change the choice later

Open the list, click Find Person at the top, and pick the other option. The change applies only to companies added from then on. Companies already on the Companies tab stay there; select them and use Find person.

Job-title screening

For job-title uploads, and people uploads with a job title column, Screen job titles before enrichment checks each title against your personas first. Titles that clearly do not fit, for example Head of HR when you sell to sales teams, are left out before any enrichment is paid for. Screening costs 0.1 credits per new job title; titles your workspace has already seen are free. If you switch it off, every contact is enriched.

Check the result

When the list has run, its leads are sorted into Found, Unsure, Not found, and Blacklist, and the source's statistics show how many companies and people were found, merged, not found, or excluded.

Signalist looks up every company in your file: for a company upload, each company in it; for a people upload, the company of each person. If looking up a company takes too long, Signalist tries it once more before the list finishes. A company that still could not be researched is not counted as not found, and no lead is added for it under Not found. Instead, the list does not read Done: the list overview and the list page show a note, for example "3 companies could not be researched — re-run the list to try them again". Click Re-Run List on the list page to try those companies again. Companies that were already researched are not looked up again.

The list overview showing the note "1 company could not be researched — re-run the list to try them again" for a finished list.

A run can also end with uploaded people who were not searched yet, for example because the list reached its prospect limit. The same note then says how many, for example "17 people could not be searched — re-run the list to try them again". When the limit is the reason, it reads "3 people could not be searched because the list reached its prospect limit — raise the limit and re-run the list to search them". Raise the list's limit in its Settings, then click Re-Run List.

  • Open a few found leads and check that Signalist matched the right person or company.
  • Look at the Exclusion Reason of leads that were not found or were excluded.
  • Signalist checks whether each person really works at the company in your file. A person who still works there is filed at that company, even when their LinkedIn profile shows the company under a slightly different name (for example with a brand or a trailing symbol added). A person who no longer works there is placed in Unsure with the reason Doesn't work there anymore. A person who turns out to work at a different company is placed in Unsure too, or in Not found when Signalist has neither their LinkedIn profile nor their email. Check these leads before you reach out.
  • If a person's LinkedIn profile could not be read, Signalist cannot tell where they work. The lead is then placed in Unsure with the reason Employer could not be verified, it is not charged, and it offers Retry. It is not filed as "Never worked at the company". See below.
  • Correct the file or the mapping and upload again if many rows failed for the same reason.

To avoid adding people who are already on another list, choose Find new people only under Who should we find? on a company list. On people and job-title uploads, switch on Only add new leads that have not been added to other lists before in the list's settings instead.

The Contacts table with the enriched leads.

People uploads: why a person is under Not found, and Retry

On a people upload, Signalist searches each person by name and company. Sometimes that search fails on our side, for example when an AI search takes too long or a data provider does not answer. Such a person is not filed as "not found": the lead shows that the enrichment failed, and nothing is charged for it.

Open the list, click Show, and choose Not found. The menu breaks Not found down by reason, and each lead shows its reason in its row:

ReasonWhat it meansRetry
Not found on LinkedIn or emailSignalist searched and found no LinkedIn profile and no email address for this person.Yes
Enrichment failed — can be retriedThe search failed on our side, so the person was never really searched. Not charged.Yes
Enrichment failed — this person's data could not be savedThe row's own data could not be stored, for example because of an unusually long value. Searching again would fail the same way. Not charged.No

Unsure: Employer could not be verified

A lead under Unsure with the reason Employer could not be verified was found, but its LinkedIn profile could not be read, so Signalist could not check that the person works at the company. Open the list, click Show, and choose Unsure to see these leads. Nothing is charged for them, and each has a Retry in its row. Retry reads the profile again:

  • If the profile can now be read, the lead is checked and filed as usual. It is charged once, like any person found.
  • If the profile still cannot be read, the lead stays under Unsure and is not charged.

Unsure: Company name ambiguous and Company not identified

When a people upload names a person's employer only by name, without a company website or LinkedIn page, Signalist matches that name only against the companies in your own lists. It does not enrich the lead with a guessed company. The lead stays under Unsure so you can check it, with one of two reasons. Open the list, click Show, and choose Unsure to see them:

ReasonWhat it means
Company name ambiguousThe employer was matched by name only, and the name is not unique in your lists.
Company not identifiedThe employer is known by name only, and none of your lists has that company.

Check these leads, and add the company website or LinkedIn page to your file if you upload the people again.

Search a lead again

  1. In the lead's row, click Retry.
  2. If other people of the list are still waiting to be searched, Signalist asks first: Search other people too? The dialog says how many people would be searched as well, and that each person searched costs 1 credit, also when no one is found. Click Search all to search the lead and the waiting people, or Cancel to search nobody.
  3. If nobody else is waiting, the search starts right away: "Searching this lead again — it updates when the search finishes".

The row updates when the search has finished. A person who is found moves to Found and is charged 1 credit, once. A person who is still not found stays under Not found and is not charged again. If the person found is already a lead of this list, the extra Not found lead is removed.

Sometimes Retry does not start a search, and a message says why:

MessageWhat to do
This list has reached its lead limit — raise the limit to search this lead againRaise the list's lead limit in its Settings, then click Retry again.
The list is paused — resume it to search this lead againResume the list, then click Retry again.
The list is running right now — try again once it has finishedWait until the list has finished.
This lead is already being searched — it updates when the search finishesNothing; the row updates on its own.
Not enough credits to search this lead againAdd credits, then click Retry again.

Troubleshooting

ProblemWhat to do
Upload stays greyed outMap one of the minimum column combinations, for example first name, last name, and company.
The file is not acceptedSave it as .xlsx. Other formats, including CSV, are not accepted.
Many people are not foundAdd a LinkedIn URL or the company website, and check for swapped columns and outdated employers.
A lead reads Enrichment failed — can be retriedThe search failed on our side. Click Retry in the lead's row.
A lead reads Enrichment failed — this person's data could not be savedCheck that row in your file, for example for an unusually long value, and upload the person again in a corrected file.
A lead under Unsure reads Employer could not be verifiedThe person's LinkedIn profile could not be read. Click Retry in the lead's row; nothing is charged unless the person is then found.
Companies are matched incorrectlyAdd the company website or LinkedIn page instead of relying on the name.
Only part of the file was importedOnly the first sheet is read, and duplicate rows are counted once.
The list says some companies could not be researchedClick Re-Run List on the list page to try those companies again.
The list has no Companies tabThe tab appears on company lists set to Only enrich companies, find people later, once companies have been added.
A company shows No new person among the top matchesEveryone found there is already in your Contacts. Work with those contacts, or switch the list to Use my contacts first.
A company list has no Only add new leads switchOn company lists it is replaced by Who should we find?. Choose Find new people only.

Frequently asked questions

Can I upload a CSV file?

No. Save the file as .xlsx first.

What happens to a column that is mapped to something Signalist cannot import?

Signalist imports a column only into the fields the mapping list offers. A column mapped to anything else, for example a leftover from an old mapping, is not imported, and the rest of the file is. The column then shows no field in the mapping, and a mapping that names such a field is refused when it is saved. If none of the file's columns has a valid field left, Signalist treats the file as not mapped yet and suggests a new mapping. Choose a field for each column you want, or Do Not import.

Which columns give the best matches?

A personal LinkedIn URL for people, and the company website or LinkedIn page for companies. A name alone is often ambiguous.

What does an upload cost?

1 credit per person searched, whether or not a match is found. For company lists, 1 credit per company plus 1 for each additional person. Job-title screening costs 0.1 per new title. With Only enrich companies, find people later, the find-person credits are charged only when you run Find person, and only for the companies you selected.

Can I keep people I already know out of a company list?

Yes. Choose Find new people only under Who should we find? in the list's Find person or Settings step. Everyone already in your Contacts is left out, and the places go to new people.

Does Find new people only cost more?

No. Your contacts are left out before any person is paid for, and a person who is left out is never charged. Each company searched costs 1 credit, as always, also when only people you already know were found there.

Can I review the companies before Signalist searches for people?

Yes. Choose Only enrich companies, find people later in the list's Find person step. This works on company uploads, Google Maps, funding, M&A, and company search lists. The companies are scored and shown on the Companies tab, and you run Find person on the ones you want.

Is Preview a test run?

For people and job-title uploads, Preview only shows how the rows will look. For company lists, Start Preview runs a real search on a sample.

Is a company that could not be researched counted as not found?

No. It stays open, and Re-Run List looks it up again. Only a company Signalist searched for and could not find ends up under Not found.

Am I charged when a person's search fails on Signalist's side?

No. A lead that reads Enrichment failed is not charged. When you click Retry, you pay 1 credit only if the person is found.

Why is a person under Unsure with "Employer could not be verified" and not under "Never worked at the company"?

Signalist could not read the person's LinkedIn profile, so it does not know where they work. Rather than guess, it keeps the lead under Unsure and lets you click Retry. Nothing is charged until the person is found.

A person still works at the company but is filed under a different name. Will they be found?

Yes. Signalist recognises the company even when the person's LinkedIn profile shows it under a slightly different display name, and files the person at your company.