How to use Dify Extractor 's output of "images"

[luojichen]

Self Checks

• I have searched for existing issues search for existing issues, including closed ones.
• I confirm that I am using English to submit this report (我已阅读并同意 Language Policy).
• [FOR CHINESE USERS] 请务必使用英文提交 Issue，否则会被关闭。谢谢！:)
• Please do not modify this template :) and fill in all the required fields.

1. Is this request related to a challenge you're experiencing? Tell me about your story.

In Dify Workflow, I added a "Dify Extractor" and uploaded a Word document that contains images.
In the "Output" section, I can see options like document, file, image, etc.

However, when I try to use an "Iteration" or "Code Execution" node, I can only see options like file, json, etc.—but not image.

2. Additional context or comments

No response

[dosubot[bot]]

Dify workflows don't natively support passing the Dify Extractor's "images" output as a selectable variable in downstream nodes like Iteration or Code Execution. This is because the workflow engine only recognizes certain types (string, number, array[file]), and "images" is output as an array of objects, not as files or a supported type, so it doesn't show up as an option in those nodes reference.

To work around this, you can add a Template node right after the Dify Extractor. In the Template node, use Jinja2 to format the images array into a JSON string, like this:

[
{% for image in extractor.images %}
  {
    "mime_type": "{{ image.mime_type }}",
    "name": "{{ image.name }}",
    "preview_url": "{{ image.preview_url }}",
    "size": {{ image.size }}
  }{% if not loop.last %},{% endif %}
{% endfor %}
]

Then, add a Parameter Extractor (JSON parser) node to parse this string into an array. Now you can connect the output to an Iteration node, and each image object will be available as item for further processing (e.g., multimodal analysis, uploading, etc.) reference.

This approach is the recommended way to handle image outputs in Dify workflows until native support for image/object types is added. If you need to process the actual image files, check if they are included in the files output—sometimes images are also added there as file objects, which can be iterated directly reference.

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}    

[luojichen]

How to set the arg name ??

[dosubot[bot]]

You can set the arg name (input variable name) in the Template node by editing the variable list in the Template node's UI. Each variable has a name field—just click and type to change it. The UI will automatically update all references to that variable in your Jinja2 template code. Variable names must be unique and can't have spaces (spaces are replaced with underscores) see implementation.

Inside your Jinja2 template, use the arg name like {{ my_var }}. However, the Template node always outputs a single variable called output. Downstream nodes (like Iteration or Code Execution) will reference the Template node's result as output, not the internal arg names you set for the template see details.

So: set your arg names for clarity inside the template, but connect downstream nodes to the Template node's output.

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}    

[luojichen]

The fact is , there is noting in "files" and "json". The url is in "images" but I can not chooise it !!!!