Troubleshooting
Troubleshoot import problems
Identify blocked websites, unreadable files, poor OCR, and failed AI structuring.
A website returns a challenge or unrelated recipe
The site is not providing its recipe to Viandly's server request. Open the page yourself and use its print view as a PDF, or copy the recipe into Paste Text.
A PDF contains no readable text
The PDF may contain page images instead of text. Import the pages through Photos, or open the file in a viewer that can perform OCR and export selectable text.
For a scanner delivery, Analyze with AI is also available when the configured model has passed the image-input test. If the provider or transcription fails, reopen the same delivery and retry or choose Use local OCR instead; the failed provider request does not consume the staged scan. If transcription succeeds but recipe structuring fails, open the resulting Needs review source, correct the text, and analyze the corrected text without rerunning vision.
OCR text is inaccurate
- Retake the image closer to the page with even lighting.
- Keep the camera parallel to the paper.
- Rotate text upright before scanning.
- Use separate images or regions for columns.
- Leave a small margin around every selected region.
- Correct fractions, temperatures, and unit abbreviations before creating the draft.
AI structuring fails
Open the failed item from Inbox. Viandly retains its source text and normally offers Retry with AI. A retry can recover from a transient provider or malformed-output failure. Repeated failures with the same source may indicate an unavailable model, rejected credential, provider limit, or source text that needs correction.
Work appears stuck
Background work is bounded per account and may wait behind an earlier import. The Inbox refreshes while active work exists. If an item reports a failure rather than a queued or running status, open it to see the retained source and available recovery action.