Skip to main content
PlanRelevé Wiki

Troubleshooting

Start from the visible symptom and change only one thing at a time. Copy the error text before reloading.

Before you start over

Note the project, the page and its mode (vector_text, mixed or raster_scan), your role, the filters, the job state and the time. If a detection is running, keep the review page open: the computation happens in your browser, and leaving or reloading the page interrupts it.

"I can't sign in"

  1. Check the email and use Forgot password?. After five failures from the same device, that device is slowed down for 15 minutes; your account is not locked, and retrying during the wait does not extend it.
  2. If the email is not verified, use Resend the verification email.
  3. For 2FA, use the latest code received. It expires after 10 minutes and five attempts; ask for a new code instead of reusing the old one.
  4. If the organization uses Entra ID, choose Sign in with Microsoft. A regular member may be refused native sign-in while the integration is active.
  5. If the message says the account is deactivated, only an owner or admin of the organization can reactivate it. Deactivation also ends existing sessions.

See Getting started: sign in and first project and Members, roles and invitations.

"The PDF won't upload" or "the analysis never finishes"

  • Upload a single unprotected PDF. The maximum size depends on the platform configuration. A file that is not a readable PDF is refused with a message, without creating an empty project.
  • Re-export a standard PDF if the file is corrupt, encrypted or password-protected.
  • Check that you are allowed to create a project. An organization Viewer cannot.
  • The message Your subscription is inactive. means uploads and exports are blocked until billing is fixed; existing projects stay viewable.
  • If the project exists but has no pages, go back to the Dashboard and click Re-analyze pages once the upload has finished.

See Dashboard and pages.

"A page has disappeared"

A disabled sheet disappears from the menus and is left out of detection, counts and the estimate, but stays in exported PDFs. On the Dashboard, find it and tick Enabled. If an old link opens another sheet, check this state.

"The legend scan finds nothing"

The automatic scan needs a vector or mixed page and a recognised legend table. A sheet whose text is drawn as strokes is read from its drawn table: the names are yours to type, with optional help from Read labels locally (OCR). If you don't know which sheet carries the legend, use Suggest legend pages. On a raster_scan page, the scan cannot read the legend:

  1. open the page in Plan review and arm the Legend symbols tool (B);
  2. click Add a symbol by drawing;
  3. frame a clean, tight occurrence;
  4. save and confirm the class.

If a scanned-page class has no symbol box, template detection cannot search for it. See Legend, symbols and manual placement.

"Measurements, cables or areas are wrong"

  • Check the scale of the page concerned; each sheet can have its own calibration.
  • Lay the ruler again on a long enough known dimension and enter the right unit.
  • After recalibrating, re-check the computed lengths, areas, coverage and prices.
  • For a run that won't attach, check Snap to symbols, Follow reference lines and Snap radius (px) in the Options tool. A point snaps to a symbol only when you click on it; Ctrl places a point without snapping.

See Scale and measurement, Cabling and piping and Areas, surfaces and voids.

"Detection returns zero, too many results or gets stuck"

For zero results, check that the class is confirmed in the legend, that the page is enabled and that the scope includes the right sheet. Lower the Confidence threshold slightly, widen the Size range ×, or use a reliable occurrence with Find similar (selected). If the legend art differs from the plan, right-click a vector occurrence → Use as example for "class", then test one page.

For too many false positives, raise the threshold, tighten the legend box and compare similar classes.

During a run, keep the review page open: detection is computed in your browser. A run rejected for lack of a browser asks you to reload the page and start again. A run reported as incomplete names the pages that were not computed and why; run detection on those pages again. A run interrupted by a reload or a restart resumes at the page it had reached when you reopen the review page. A failed job can be re-run on a smaller scope after reading the message. Confirmed, manual, ignored and to-review decisions are kept on a re-run; only the scope's unreviewed automatic candidates are replaced. See Automatic detection.

"Symbols are still missing"

Zoom out for a population check, not just a box check. Use Unknown symbols to see repeated shapes with no class, each with its thumbnail. Attach to… then Apply selected class… files them under an existing class; Create… produces a new class and candidates to review; Ignore closes an out-of-scope suggestion. Add an isolated miss with Draw a box. Text matches deliberately stay candidates, even with a high score. The full method is in Review, statuses and quality.

"The count or the estimate doesn't add up"

  1. Clear the filters and check the statuses: only confirmed and manual enter the default reviewed count. The estimate shows how many detections are waiting for your review; they are not priced until they are confirmed.
  2. Re-enable any sheet that must contribute to the totals.
  3. Check the class's assembly recipe, quantities and units.
  4. In the estimate, check the labour rate, margin, run prices, additional lines and missing prices.
  5. Check the tax group. A group chosen explicitly is frozen in the estimate, so an old rate is not fixed by changing only the organization default.

See Assemblies and bill of materials and Estimating, labour, margins and taxes.

"The export won't go" or "it holds the wrong boxes"

An export needs the right project role and an eligible subscription. Reload after a role or billing fix. Then check the Include candidates option: the reviewed CSV normally targets confirmed/manual items, while an annotated review PDF can include candidates. Exports reflect the state at the time of the click; generate them again after a change. Details: CSV, PDF and Excel exports.

"Access denied", MCP 401 or MCP 403

A project share can override the organization role on that project. Ask the admin to check the effective role, not just the organization title. For MCP, 401 usually means a missing, invalid or revoked token, or a deactivated creator; 403 often means MCP is turned off for the organization or the permission is missing. A read-only token cannot call a write tool. See API and MCP integrations.

Preparing a support request

Give the project, the page, the PDF mode, the action, the time, the browser, the job status and the exact message. Never send an MCP token, password, 2FA code or full customer plan through an unapproved channel.

See also