# Blender add-on

> Submit scenes, choose remote render settings, monitor jobs, and download completed output without leaving Blender.

- Canonical HTML: https://superlumin.al/docs/blender-addon
- Markdown endpoint: https://superlumin.al/docs/blender-addon.md
- Structured page data: https://superlumin.al/docs/blender-addon.json
- Last updated: 2026-08-04
- Author: Superluminal Engineering

## Related Superluminal Research

- [The Superluminal render interface](https://superlumin.al/interface): A visual tour of Superluminal's Blender add-on, file checks, live job page, previews, and output downloads.
- [Blender project dependencies](https://superlumin.al/dependencies): Before upload, Superluminal checks textures, linked Blender files, UDIMs, sequences, caches, fonts, and other external inputs.
- [Add-ons on render nodes](https://superlumin.al/addons): Select the Blender add-ons that affect a render. Superluminal packages their files, uploads them with the project, and enables them on each render node.

## Complete documentation

The Superluminal add-on is the supported path for submitting Blender scenes and downloading full render output. Its main panel lives in **Render Properties → Superluminal Render**.

### Two apps, one workflow

Configure and submit in Blender. Use the web app for deep monitoring and review. Return to Blender to download full-quality output.

## Panel map

![The Superluminal Render panel with project, job name, frame range, render pattern, format, and submit actions](https://superlumin.al/docs/images/blender/addon-submit-panel.png)

*The whole add-on lives in one Render Properties panel, with collapsible sections below the submit actions.*

- [Annotation 1: Project and job name](/docs/blender-addon/job-submission#name-and-project)

- [Annotation 2: Frame range and render pattern](/docs/blender-addon/job-submission#frame-range)

- [Annotation 3: Image format](/docs/blender-addon/job-submission#image-format)

- [Annotation 4: Submit a still or the animation](/docs/blender-addon/job-submission#what-happens-after-you-click-submit)

- [Annotation 5: Optional automatic frame download](/docs/blender-addon/manage-and-download#download-output)

The controls change with connection and project state. Each area of the panel has its own guide:

1. **Connection**: browser-based account connection, with password sign-in as a collapsed fallback. → [Install and connect](/docs/blender-addon/install-and-connect)
2. **Project and job**: project picker, job name, frame range, render pattern, image format, and submit buttons. → [Submit a job](/docs/blender-addon/job-submission)
3. **Upload Settings**: ZIP or PROJECT mode, project-root controls, path warnings, and enabled add-ons to package. → [Upload settings](/docs/blender-addon/upload-settings) and [Add-ons and dependencies](/docs/blender-addon/addons-and-dependencies)
4. **Render Node Settings** and **Experimental**: farm Blender version, error-finish behavior, and the Persistence Engine. → [Render-node settings](/docs/blender-addon/render-node-settings)
5. **Manage & Download**: refresh and filter jobs, open a job in the browser, select a local path, and download output. → [Manage & Download](/docs/blender-addon/manage-and-download)

Clicking a submit button opens a separate terminal window with the submission transcript. [Read the submission terminal](/docs/blender-addon/submission-terminal) explains it stage by stage.

## Basic workflow

### Connect

Choose **Connect to Superluminal** and complete the browser flow.

### Select a project

Choose where the job and reusable project files belong.

### Configure

Set naming, frame range, render pattern, image format, upload mode, add-ons, Blender version, and experimental behavior.

### Submit

Use **Submit Still** for one chosen frame or **Submit Animation** for the configured range, then let the terminal finish.

### Inspect

Select the job in **Manage & Download** or open its full web view.

### Download

Choose a local folder and run **Download job output**.

- [First render](/docs/getting-started): The whole loop once, end to end, with one test frame.
- [Web app](/docs/web-ui): Where submitted jobs are reviewed: frames, previews, charts, and logs.
- [Troubleshooting](/docs/blender-addon/troubleshooting): Diagnose connection, packaging, registration, render, and download issues.