> ## Documentation Index
> Fetch the complete documentation index at: https://docs.justflow.it/llms.txt
> Use this file to discover all available pages before exploring further.

# Import a photo, PDF, or .bpmn file into the editor

> Upload a whiteboard photo, a procedure PDF, or an existing BPMN file and let Just Flow It convert or continue editing it as a BPMN 2.0 diagram.

Just Flow It can read several types of files and turn them into editable BPMN 2.0 diagrams. Snap a photo of a whiteboard sketch, drop in a procedure document, or bring in an existing `.bpmn` file — the AI handles the conversion so you can skip the manual redrawing. Choose the import type that matches what you have on hand.

<Note>
  Whiteboard photo and PDF import use AI processing and require an active **Pro or Team** subscription. Importing an existing `.bpmn` file is available on **all plans**, including Free.
</Note>

## Import your file

<Tabs>
  <Tab title="Whiteboard Photo">
    If you've sketched a process on a physical whiteboard, Just Flow It can read the photo and generate a clean BPMN diagram from it — no manual retracing required.

    **What works best:**

    * Photos taken straight-on with good lighting and minimal glare
    * Clear box-and-arrow sketches rather than dense handwritten notes
    * Legible labels on each shape so the AI can assign the correct task names

    <Steps>
      <Step title="Open the import panel">
        On the home screen or inside the editor, click **Import** and select **Whiteboard Photo**.
      </Step>

      <Step title="Upload your photo">
        Click **Choose File** and select a JPG, PNG, or HEIC image from your device, or drag and drop the photo directly onto the upload area.
      </Step>

      <Step title="Let the AI process the image">
        Just Flow It analyses the photo, identifies the shapes and flow, and generates a BPMN 2.0 diagram. This typically takes a few seconds.
      </Step>

      <Step title="Review and refine">
        The diagram opens in the editor. Check that all steps, decisions, and roles have been captured correctly. Use the text input to describe any missing details and click **Regenerate** to update the diagram.
      </Step>
    </Steps>

    <Tip>
      For best results, take the photo in landscape orientation and crop out any surrounding whiteboard frame before uploading.
    </Tip>
  </Tab>

  <Tab title="PDF Procedure">
    Drop in a procedure document, policy manual, or standard operating procedure (SOP) as a PDF and Just Flow It extracts the process steps and converts them into a BPMN diagram.

    **What works best:**

    * PDFs with numbered steps or clearly structured sections
    * Documents that describe a single end-to-end process rather than a broad policy overview
    * Text-based PDFs (not scanned images) for the most accurate extraction

    <Steps>
      <Step title="Open the import panel">
        On the home screen or inside the editor, click **Import** and select **PDF Procedure**.
      </Step>

      <Step title="Upload your PDF">
        Click **Choose File** and select a PDF from your device, or drag and drop it onto the upload area. Files up to 20 MB are supported.
      </Step>

      <Step title="Let the AI extract the process">
        Just Flow It reads the document, identifies the process steps, decision points, and roles mentioned in the text, and generates a BPMN 2.0 diagram.
      </Step>

      <Step title="Review and refine">
        The diagram opens in the editor. Procedure documents often contain more detail than a single diagram can show — review the output and add or remove steps as needed using the text input or by editing elements directly.
      </Step>
    </Steps>

    <Warning>
      Scanned PDFs (i.e., images of printed pages) may produce less accurate results than text-based PDFs. If accuracy is important, copy the key process steps into the text input instead.
    </Warning>
  </Tab>

  <Tab title="BPMN File (.bpmn)">
    If you already have a BPMN 2.0 file from Camunda, Bizagi, Signavio, draw\.io, or another tool, you can import it directly into Just Flow It and continue editing it without starting from scratch.

    <Steps>
      <Step title="Open the import panel">
        On the home screen or inside the editor, click **Import** and select **BPMN File (.bpmn)**.
      </Step>

      <Step title="Upload your .bpmn file">
        Click **Choose File** and select your `.bpmn` file, or drag and drop it onto the upload area.
      </Step>

      <Step title="Review the imported diagram">
        Just Flow It parses the BPMN XML and renders the diagram in the editor with all elements, positions, pools, lanes, and labels preserved. Verify that everything looks as expected.
      </Step>

      <Step title="Continue editing">
        Use the text input to ask the AI to extend or modify the diagram, or edit elements manually in the canvas. When you're done, export back to `.bpmn` or any other supported format.
      </Step>
    </Steps>

    <Note>
      BPMN file import is available on all plans, including Free. The imported file must conform to the BPMN 2.0 standard for best compatibility.
    </Note>
  </Tab>
</Tabs>