Skip to content

Reference

Troubleshooting

The problems the product itself tells you about, what causes each one, and how to fix it.

Checked against the live product 8 Oct 2026 Changelog Copy as Markdown

Each answer below covers a problem Truffle reports on screen or a setting that has to be in place. Start with the heading closest to what you see. If your problem is not here, the help center has more. Help is also in the ? menu in the sidebar.

Getting candidates in

Why didn’t my Indeed applicants import?

Almost always, the Indeed setting “Send an individual email each time someone applies” is unticked. Adding your Truffle import address in Indeed only tells Indeed who to notify. That checkbox is what sends each application. Without it, Indeed sends summaries, and nothing imports. See Import applicants from Indeed.

Check each step of the setup:

  1. On the position, open Get candidates and turn on Auto-import applicants. Copy the import address it shows. Every position has its own.
  2. In Indeed, open the job, choose Edit job post, then Application method. Under “Application updates and access to candidates on Indeed”, click ”+ Add email” and paste your import address. Add it here, in Indeed itself. Forwarding Indeed’s emails from your own inbox imports applicants, but their invites can’t be delivered.
  3. On the same screen, tick “Send an individual email each time someone applies”. Save the job, then confirm.
  4. Indeed usually sends no resume. To score resumes, turn on Resume scoring for the position in Truffle. Candidates add their resume on the last step of their interview, and Require a resume to submit, next to the resume criteria, makes it required.

If a position has had nothing import for a few days, Truffle flags it. Emails Truffle cannot import show in the position’s Import activity with the reason and what to do, and your account gets an email when imports start failing. Accounts more than 14 days past cancellation, or blocked, stop importing.

Indeed emailed my import address asking it to create an account

You do not need to do anything. Indeed sends that invitation whenever an address is added, including on correctly set up jobs. It has no effect on whether applications reach Truffle, and Truffle shows you that it arrived.

Why is a forwarded application waiting instead of importing?

Truffle accepts forwards from a teammate’s sign-in address, and notifications from Indeed, LinkedIn and ZipRecruiter, without review. Email from any other sender waits for a manager or owner to choose Import once, Always allow for that exact address, or Ignore. Unreviewed emails expire after 14 days. To avoid the wait, forward from the email address you sign in with. For Indeed, forwarding imports the applicant, but Truffle holds their invite back. Add the import address on the job in Indeed instead, see Indeed applicants import, but invites aren’t going out.

Why was an imported candidate invited automatically, or not invited?

It follows how the position is set up. On an Apply first position, imported candidates wait in the candidate list and nothing is sent until you invite them. On a one-sitting position, or one with no resume step, they are invited to their interview automatically. Indeed applicants are invited at their Indeed address, from the position’s import address, and the invite arrives in their Indeed inbox. The exception is an Indeed applicant who was forwarded in from your own inbox. Truffle holds their invite back and tells you why, see Indeed applicants import, but invites aren’t going out. Once a candidate’s resume gives Truffle a personal email, Truffle emails that address instead.

Indeed applicants import, but invites aren’t going out

The applicants were most likely forwarded from your own inbox, by hand or with a rule, instead of Indeed sending them to the import address. Forwarding still imports the applicant. But Indeed only delivers Truffle’s invite when the import address is added on the job, so Truffle holds the invite back and tells you why.

To fix it, add the import address on the job in Indeed. Open the job, choose Edit job post, then Application method. Under “Application updates and access to candidates on Indeed”, click ”+ Add email”, paste the import address and tick “Send an individual email each time someone applies”. Save, then Confirm. New applicants then get their invites in their Indeed inbox, from your company.

Applicants who already imported are not invited later. Message them in Indeed, or add their personal email to their profile. Forwarding works as before for other boards and for email applications. See Indeed applicants.

Why was my resume upload refused?

Uploads take PDF or DOCX files, up to 5 MB each and 50 per upload, and you confirm an employer attestation first. Scanned PDFs are read with text recognition. An upload that is still refused says why.

A candidate finished without a resume

Candidates now record first and add their resume on a final step at the end. If the position’s Require a resume to submit switch is off, they can skip that step and send one later. New positions start with it off. A candidate who skips gets an email about an hour after finishing, then one reminder 48 hours later, with a link to add the resume that works for 14 days. The candidate’s Resume tab shows the date the link was sent. To make the resume required, turn the switch on under Resume criteria in position setup.

Ask what the page says.

  • “This interview link is incomplete” or “This application link is incomplete” means the link was cut off or mistyped. The page explains this and lists three steps to get a working link, instead of showing the employer login. Stray characters stuck to the end of a link are stripped, and it opens on its own.
  • The candidate’s own deadline has passed. A link with a completion deadline stops accepting submissions after it. Extend the deadline from the candidate’s row, or for several candidates at once.
  • The position has expired. Its link shows an expired page. Reopen the position or extend its deadline.
  • The position is closed. Closing stops the link and careers page the same day. Reopen it with Reopen position.
  • The candidate was deleted. A deleted candidate’s interview link stops working, and deletion cannot be undone.
  • Your account is paused or closed. Invites and reminders from a paused or closed account are refused with an explanation, so no link goes out that won’t open.

A candidate started but can’t get back in

A candidate who reloads the page, or comes back on the same browser, continues where they left off. They do not need a new link.

On another browser or device, they enter their email and see “Check your email for a link to continue your application”. The emailed link gets them back in, and it works on another device. Only the invitation deadline and the position’s expiry stop a resume.

A candidate can’t or won’t record video

Point them to Request an alternative on the welcome page. They give a reason, and the request appears on your Home and in the candidate list, where you mark it handled. Requests go to your Accommodation contact email, or to the account owner if none is set. For problems during the screening itself, the Need help? link in the screening header opens support chat.

A candidate’s camera or microphone isn’t working

If the browser’s permission request failed, the Allow and Retry buttons on the camera and microphone check ask again. When a camera or microphone is missing, or another app is using it, the page names that as the problem. A candidate who still can’t record can use Request an alternative.

A candidate created an account by mistake

Candidates do not need a Truffle account. They take the screening from their link. Sign-up now asks what brings you there, and a candidate who lands on it looking for their interview is told they don’t need an account.

A candidate withdrew

The candidate withdrew from their interview link before finishing. All their reminders stop. You see Withdrew in the candidate list, in filters and exports, on the candidate’s timeline, and in your Inbox. See Candidate statuses and emails.

A candidate wants their data deleted

Point them to Request deletion of my data on their interview pages. These requests used to go through our support inbox. The candidate confirms by email, and nothing happens until they do. Once confirmed, their data disappears from your account straight away and is permanently deleted, backups included, within 30 days. You get an email naming the position.

An owner can also delete a candidate from your side, including one who is still mid-interview. The confirmation warns that the candidate’s interview link will stop working.

Why isn’t a candidate getting reminders?

Check these in order:

  • The reminders are switched off for the position, under Candidate emails and reminders.
  • The candidate is suppressed. They unsubscribed, or someone recorded an opt-out, and every send path checks that record.
  • You uploaded their resume, or they are waiting on an Apply first position. Neither gets email until you invite them.
  • The candidate withdrew. Withdrawing stops all reminders.
  • Your account is paused or closed. Reminders are refused with an explanation.

Why can’t I send another reminder?

Send additional reminder has a 24-hour wait between sends for the same candidate. The wait applies across browsers and teammates, so a reminder a teammate sent starts it too.

Why are candidate replies going to Truffle?

Companies created before 17 September 2026 keep their previous routing, where replies reach Truffle, until an owner or admin picks an option. Choose Reply to the sender or Use one address in Settings, under Company, Candidate email. See Customize candidate emails.

Replies from Indeed applicants work differently. They stay in Indeed, see the next answer.

Where is the candidate’s reply from Indeed?

In Indeed. When a candidate replies to a Truffle email in their Indeed inbox, a copy reaches the position’s import address. Truffle logs it under Import activity, on the position’s Get candidates page, as Replied in Indeed — read it there. It does not create a duplicate candidate. Open the conversation in Indeed to read and answer the reply.

Why is the personalized note missing from an email?

{personalized_note} is left blank when there is nothing specific to say about the candidate. The completion email only includes a note if your template adds the tag.

Setting up a position

Why can’t I activate my position?

Review and activate lists everything that blocks go-live as rows that link to the fix, and Activate position stays off until they are cleared. The blockers are:

  • A position description under 200 characters. Define the role shows the count as you type.
  • Resume criteria Truffle drafted that nobody has reviewed. Review reads Truffle's suggested resume criteria haven't been reviewed, with Review resume criteria.
  • Qualification checks Truffle drafted that nobody has reviewed. Review reads Truffle's suggested qualification checks haven't been reviewed, with Review qualification checks.
  • Resume scoring switched on with no criteria.

To clear a drafted section, read it and choose Looks right, or edit it.

Review and activate with one thing to fix: the suggested resume criteria have not been reviewed, with a link back to Review resume criteria.
Review and activate with one thing to fix: the suggested resume criteria have not been reviewed, with a link back to Review resume criteria.

Why won’t Next: Configure work?

At least one component has to be on, or the page reads Nothing is on. Turn on at least one component. Qualification checks cannot run alone. With only checks on, the card reads Needs Resume, Video Interview, or Assessments enabled to run. Switch on one of those three.

Qualification checks switched on alone, reading Needs Resume, Video Interview, or Assessments enabled to run, with Next: Configure off.
Qualification checks switched on alone, reading Needs Resume, Video Interview, or Assessments enabled to run, with Next: Configure off.

Why can’t I save the Personality section?

Every trait needs a choice, and the section says how many are left, such as 4 traits still need your selection before saving. At least one trait must be set to something other than Not important.

Why can’t I create a qualification check?

Create check stays off until the rule is complete, and the form says what is missing.

Why can’t I add my own interview question?

The fairness check reads your question as you type. This question can't be added as written means the question needs the change shown before it can be added. Potential bias risk means you can still add it after you acknowledge the flag, with an optional business reason. A custom question is limited to 150 words, and an interview holds up to 10 questions.

Candidates don’t see my edits to a live position

Edits to a live position are saved as a draft. Candidates keep seeing the current version until you publish from Review with Publish changes. A position with a waiting draft shows an Unpublished chip on the positions list.

I can’t delete, duplicate or reopen a position

  • Delete is only available on closed or archived positions, for the position’s owner, account owners and admins.
  • Duplicate is disabled while a position is archived.
  • An archived position must be unarchived before it can be reopened.
  • Reopening tells you anything that has to be fixed before the position can go live again, and links to Edit position.
  • A paused account cannot open, reopen or duplicate a position, and the message says so. Owners and admins can resume from Billing at any time. When you come back, a card on Home lets you choose which positions to reopen.

I can’t find a position

Archived positions are hidden from the main list. Owners and admins find them with the Archived filter. Global search does not return deleted positions or demo jobs.

Scores and results

Why is a score missing?

  • The candidate has not completed the screening. The AI analysis runs when a candidate finishes and moves to For Review.
  • The signal cluster shows only what the position measures. Overall appears only when a position has two or more score types.
  • A signal reads Not scored or Opted out. A tooltip on the label explains it.
  • A personality trait you set to Not important reads Not scored.
  • Environment Fit shows an aligned count and a signal tier, never a percentage.
  • The resume summary is held until after the video interview.

Why is there no Clarity read on a candidate?

Clarity read (beta) is off by default and applies only to interviews completed after you turn it on. Earlier interviews do not get one. It reads English only.

Why doesn’t a resume score show in Ashby?

Resume screening does not post a score into Ashby. Ashby gets the completed status and a View in Truffle link to the full breakdown. Interview match scores and rolled-up assessment scores do post. In Pinpoint, assessments come back as a tier only.

Reviewing

Why can’t I see what the team thinks of a candidate?

Members do not see Team feedback until they submit their own review. This keeps each review independent.

Why can’t I change the scorecard?

A scorecard locks once criterion ratings have been submitted, so the criteria cannot change after reviews start.

A key press changed a candidate’s status

In Magic Review, A advances, H holds and R rejects. Shortcuts with a modifier key, such as refresh, pass through to your browser. To undo a decision, choose Clear decision from the Decide menu.

Why can’t I download a PDF of a candidate?

The PDF needs a selection that includes interview responses. Exporting several candidates as one zip of PDFs is on annual plans only.

Why am I not getting completion emails?

Notification settings are per person. In Settings, Notifications, you may have chosen only candidates above a match score threshold, or turned the emails off.

Why am I not getting emails about mentions or replies?

The Team activity card in Settings, Notifications sets how much reaches your email: Everything, Mentions only or In-app only. Emails wait about five minutes and only send if you haven’t already read the notification in the app. Reactions never send email. Everything still collects in your Inbox in the sidebar. See Working as a team.

Integrations

Why can’t I connect an integration?

Connecting needs a paid plan. On a free account the Integrations page shows “Integrations are available on paid plans”, and on a trial the Ashby card is locked.

Ashby results stopped arriving

Check the Ashby card on the Integrations page. It shows Connected, Degraded or Action needed, and when results last flowed. Reconnect generates a new Truffle key to paste into Ashby. The old key stops working as soon as you reconnect.

A Pinpoint action doesn’t offer my position

Each Pinpoint action only offers open positions set up for it. Closed, archived and expired positions refuse new sends. Screen resume with Truffle needs a PDF or DOCX resume up to 5 MB. If you replaced the key, the old one keeps working for 7 days.

Account and billing

Billing says Payment due, or the account is on hold

A failed payment shows as Payment due with the retry date, instead of the next renewal. It opens a grace period with a warning banner. If it is not resolved, the workspace moves to a hold state. An account on hold for payment sees how to fix it: the “account on hold” message links to the billing page, where you update the card on file. The plan card warns ahead of time when your card expires before the next payment. Use the Update link next to the card on file to change it.

My trial ended

An ended trial no longer locks you out. You can still review candidates on your open positions until they close 14 days later. Creating a new position asks you to choose a plan. While the trial runs, the sidebar chip shows the days left and has a Choose a plan button. Members who can’t choose a plan are told to ask an owner or admin. See Plans and credits.

I cancelled by mistake

Before the end date, choose Undo cancellation on the billing page, or use the undo link in the cancellation email.

I can’t see billing history

Billing history is visible to owners and admins only.

I lost my authenticator app

With two-factor authentication on, sign-in asks for the 6-digit code from your authenticator app, with a recovery code as the fallback. Enter one of the recovery codes you saved when you turned two-factor on. Once you are in, you can regenerate your recovery codes or turn two-factor off under Settings, Security. See Account and security.

I was signed out on my other devices

Turning two-factor on or off, resetting your password or changing your password signs out every other session. Sign in again on those devices. You also get an email whenever two-factor is turned on, turned off or reset.

I can’t change my email address

Your email address is read-only in Settings. Contact support to change it.

What it does not do

  • Truffle never signs in to Indeed. Imports work only when Indeed sends an individual email for each application.
  • Indeed applicants forwarded in from your own inbox are not invited, and are not invited later once the address is added in Indeed.
  • Replies from Indeed applicants are read and answered in Indeed, not in Truffle.
  • Email from unrecognized senders is not imported until a manager or owner reviews it, and expires after 14 days.
  • A position does not go live with a short description or unreviewed drafted criteria or checks.
  • Clarity read does not apply to interviews completed before it was turned on.
  • Deleted candidates cannot be restored, and their interview links stop working.
  • Integrations, the API and Zapier do not work on a free account.
  • Candidate deletion requests do not go through support. Candidates make them from their interview pages, and nothing is deleted until they confirm by email.
  • A paused account cannot open, reopen or duplicate positions, or send invites and reminders.

See something here that doesn't match what you see in Truffle? Tell us and we'll fix the page.

Start typing to search 300+ pages on hiretruffle.com.

Website visitor reviewRanked by Overall
YOU
You (probably)For Review · Applied via hiretruffle.com/how-it-works/troubleshooting
Overall
Strong
Resume match
HighRelevant experience includes being on the website. (Okay the bar isn't high.)
Interview
Mixed
Requirements
1 unmet
  • Hires people
  • Read this far
  • Started a free trial

Reasoning

Match detected 🎯

We built an entire hiring metaphor to avoid saying “wait, don’t go.” Which is ironic because Truffle helps you get to the point with your candidate pool.

you're the bossAdvanceStart free trial7 days, 30 credits, no credit cardHoldBook a demo30 minutes on your real hiring problem