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

# Using add-ons and extensions with Renderjuice

> Step-by-step guide to zipping, uploading, and using your custom Blender add-ons and extensions for rendering on Renderjuice.

This guide will help you prepare and use your custom addons for rendering on our platform. By the end of this guide, you’ll be able to upload your addons, and integrate them seamlessly into your render jobs.

While we continue improving this workflow, some add-ons still require extra setup depending on how they store data or caches. We have successfully tested it with the following addons:

* **PSA**
* **Flip Fluid**
* **Shakify**
* **Nishita Sky**
* **Geo Scatter**

And following extensions:

* **Noise Nodes**

If you encounter any issues, please don’t hesitate to contact our support team.

## Instructions

To use add-ons with Renderjuice, you need to zip your add-on folders and upload them to your Renderjuice account.

<Steps>
  <Step title="Prepare Your Add-on">
    <a id="addon-location" />

    Before uploading your add-on, you need to make sure it's working as expected locally.

    * Ensure your add-on is working as expected locally, by rendering a frame. Set the sample size to lower values to speed this up.
    * Once you've confirmed it's working, zip the add-on folder from your local Blender add-ons or extensions directory and prepare to upload.
    * Ensure that you don't change the folder name when zipping it.

    <Warning>
      Upload the add-on folder that is already installed on your machine. Do not upload the original installer or download archive from the add-on website unless that archive is the exact same folder already installed in Blender.
    </Warning>

    <Tip>
      If you use [Blend Project Packer](/renderjuice-101/blend-project-packer),
      its **Bundle Selected Add-ons** option can copy selected installed add-ons into
      `addons/legacy/*.zip` or `addons/extensions/*.zip` inside the packed project.
      Those generated zips can be uploaded on the Renderjuice Add-ons page, but they
      still must be uploaded, validated, and selected in the render job separately.
    </Tip>

    You can find the add-on folder here:

    <Tabs>
      <Tab title="Windows">
        To show hidden files in File Explorer:

        ```
        View > Show > Hidden items
        ```

        Then navigate to:

        <CodeGroup>
          ```bash Legacy add-ons theme={null}
          %appdata%\Blender Foundation\Blender\[blender version]\scripts\addons\
          ```

          ```bash Extensions theme={null}
          %appdata%\Blender Foundation\Blender\[blender version]\extensions\
          ```
        </CodeGroup>
      </Tab>

      <Tab title="MacOS">
        To show hidden files in Finder:

        ```
        Command + Shift + Dot
        ```

        Then navigate to:

        <CodeGroup>
          ```bash Legacy add-ons theme={null}
          /Users/[user]/Library/Application Support/Blender/[blender version]/scripts/addons/
          ```

          ```bash Extensions theme={null}
          /Users/[user]/Library/Application Support/Blender/[blender version]/extensions/
          ```
        </CodeGroup>
      </Tab>

      <Tab title="Linux">
        To show hidden files in Nautilus:

        ```
        View > Show hidden files
        or 
        press Ctrl + H
        ```

        Then navigate to:

        <CodeGroup>
          ```bash Legacy add-ons theme={null}
          $HOME/.config/blender/[blender version]/scripts/addons/
          ```

          ```bash Extensions theme={null}
          $HOME/.config/blender/[blender version]/extensions/
          ```
        </CodeGroup>
      </Tab>
    </Tabs>
  </Step>

  <Step title="Upload Your Add-on to Renderjuice">
    After you've zipped your add-on, you can upload it to Renderjuice.

    1. Login to [app.renderjuice.com](https://app.renderjuice.com) and navigate to the [Add-ons](https://www.app.renderjuice.com/addons) page.
    2. **Drag and drop** or click **Upload** to upload the addon zip file.

    <Frame caption="Add-ons Page">
      <img src="https://mintcdn.com/renderjuice/LAVdNoNpZYyOHLg8/images/examples/addons/addons-page.png?fit=max&auto=format&n=LAVdNoNpZYyOHLg8&q=85&s=22e1051dea54aa49951930611fce36bc" width="4376" height="2654" data-path="images/examples/addons/addons-page.png" />
    </Frame>

    3. Once uploaded, you can see your add-on in the list of uploaded add-ons in the **Add-ons** page. Wait for it to finish validating before using it in a render job.

    <Frame caption="Uploaded Add-ons">
      <img src="https://mintcdn.com/renderjuice/LAVdNoNpZYyOHLg8/images/examples/addons/uploaded-addons.png?fit=max&auto=format&n=LAVdNoNpZYyOHLg8&q=85&s=ef3402b78f20ce32e656fffa65744b11" width="3176" height="2222" data-path="images/examples/addons/uploaded-addons.png" />
    </Frame>
  </Step>

  <Step title="Use uploaded Add-on in a Render Job">
    Great job! Now you can use your add-on in a render job.

    1. Navigate to the **Home** page.
    2. Upload your blend file or choose one from recently uploaded.
    3. It will redirect you to the **Configure Render** page to set your render parameters.

    <Frame caption="Configure Render Page">
      <img src="https://mintcdn.com/renderjuice/LAVdNoNpZYyOHLg8/images/examples/addons/render-config.png?fit=max&auto=format&n=LAVdNoNpZYyOHLg8&q=85&s=3b164516aa47bb5bb52f35a159102321" width="1618" height="1980" data-path="images/examples/addons/render-config.png" />
    </Frame>

    4. In the **Add-ons** section, you can select the add-on you uploaded to use.

    <Tip>
      * If your addon isn’t listed, click the **Upload Addon** button to upload it.
      * This opens the Addons page in a new tab.
      * After uploading the addon and when it finishes validating, return to your render configuration tab, where the newly uploaded addon will now be selectable.
    </Tip>

    <Frame caption="Select Add-ons">
      <img src="https://mintcdn.com/renderjuice/LAVdNoNpZYyOHLg8/images/examples/addons/select-addons.png?fit=max&auto=format&n=LAVdNoNpZYyOHLg8&q=85&s=9967d201798ae085a67affc4a6c3d39a" width="1574" height="906" data-path="images/examples/addons/select-addons.png" />
    </Frame>

    5. Click **Continue** to **validate** your scene and start your **render** 🎉.

    <Warning>
      Monitor the render to ensure your add-on is working as expected, if any issue detected cancel the render, to avoid wasting credits.
    </Warning>
  </Step>
</Steps>

## What statuses mean

* **Validating** - Renderjuice is checking the archive structure and addon metadata.
* **Validated** - The add-on is ready to be selected in a render job.
* **Failed** - The archive could not be validated. Review the error in the Add-ons page, fix the archive, and upload it again.

## Common mistakes

* Uploading the original installer or website download archive instead of the installed add-on folder from Blender.
* Renaming the add-on folder before zipping it.
* Trying to use the add-on before validation finishes.
* Leaving packer-bundled add-on zips inside the project upload and expecting
  Renderjuice to install them automatically.
* Assuming the add-on archive is enough when the scene also depends on baked caches or simulation data.

## Important Notes

* Monitor the render to ensure your add-on is working as expected, if any issue detected cancel the render, to avoid wasting credits.
* For some addons e.g Flip Fluid, you need to **bake** your simulation locally and put the cache in the same zip as your `.blend` file. For more details see the [Fluid Simulations](/rendering-with-blender/fluid-simulations-with-mantaflow) guide.

## Useful Links

* [Using Fluid with Render Farms](/rendering-with-blender/fluid-simulations-with-mantaflow)
* [Using Simulation Nodes with Render Farms](/rendering-with-blender/simulation-nodes)
* [Preparing a project with Blend Project Packer](/renderjuice-101/blend-project-packer)
* [Preparing Your Project for Render Farms](/renderjuice-101/preparing-blender-file)

<Tip>
  Having trouble or something doesn't seem right? Just chat with us—we're happy to help and respond quickly!
</Tip>
