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

# Odoo installation

> Install the Filecheck module on Odoo eCommerce, add your keys, and check customer files before they reach the cart.

The Filecheck module puts the Element on your Odoo product pages, gates **Add to cart** until the file passes, and saves the print-ready files on the sale order. It works with Odoo **17 and 18** with the **eCommerce** app, self-hosted or on Odoo.sh.

> [card] [Odoo 18 on the Apps Store](https://apps.odoo.com/apps/modules/18.0/filecheck)
>
> The official listing for Odoo 18. Free, LGPL-3.

> [card] [Odoo 17 on the Apps Store](https://apps.odoo.com/apps/modules/17.0/filecheck)
>
> The official listing for Odoo 17. Free, LGPL-3.

> [!NOTE]
>
> Odoo Online (the SaaS at odoo.com) cannot install third-party modules. Use a self-hosted Odoo or Odoo.sh.

**1. Install the module**

Download the module for your Odoo version from the Odoo Apps Store ([Odoo 18](https://apps.odoo.com/apps/modules/18.0/filecheck) or [Odoo 17](https://apps.odoo.com/apps/modules/17.0/filecheck)) and extract the `filecheck` folder into your addons path. On Odoo.sh, add the [GitHub repository](https://github.com/PrintApp/filecheck-odoo) as a submodule on the branch that matches your Odoo version (`18.0` or `17.0`).

Restart Odoo, open **Apps**, click **Update Apps List**, search for **Filecheck** (remove the default **Apps** filter if it does not show), and click **Activate** on **Filecheck Print File Preflight**. It installs Odoo's eCommerce app too if you do not have it yet.

**2. Add your keys**

Go to **Website → Configuration → Settings** and scroll to the **Filecheck** section. Enter your **publishable key** and **secret key** from the [Dev Hub](https://admin.filecheck.io/devhub), click **Save**, then click **Test connection and sync workflows**. Your workflows and connectors load into the dropdowns. Pick a **Default Workflow** and save.

![The Filecheck section of Odoo's website settings, with the keys, default workflow and artwork options](https://mintcdn.com/filecheck/y7NLwl17LHufHDfA/images/odoo-settings.png?fit=max\&auto=format\&n=y7NLwl17LHufHDfA\&q=85\&s=e2a20d92c2f96e8b30fbb15d53f9e093)

**3. Enable Filecheck on a product**

Open a product and go to its **Filecheck** tab. Set **Filecheck** to **Website's default workflow**, or choose **A specific workflow** and pick it. Products are off until you switch them on. Optionally set **Collect Artwork**, the **Upload widget** (inline or a button that opens a dialog) and a [Connector](https://filecheck.io/docs/element/connectors.md).

![The Filecheck tab on an Odoo product](https://mintcdn.com/filecheck/y7NLwl17LHufHDfA/images/odoo-product-tab.png?fit=max\&auto=format\&n=y7NLwl17LHufHDfA\&q=85\&s=ca954d2edb576b3b217029b1d913c231)

**4. Test the gate**

Open the product page. The upload sits above **Add to cart**, which stays disabled until the file passes. Upload a test file, add the product to the cart and check out. The cart line shows the file name, and each uploaded file gets a cart line of its own.

**5. Find the files on the order**

When the order is confirmed, it is sent to Filecheck. Open the sale order and go to its **Filecheck** tab: each line shows its outcome, proofs and download links, with **View on Filecheck** to open the job. Once the job has finished, its files are attached to the order, with a note in the chatter.

![The Filecheck tab on an Odoo sale order, with file outcomes, proofs and the files saved on the order](https://mintcdn.com/filecheck/y7NLwl17LHufHDfA/images/odoo-order.png?fit=max\&auto=format\&n=y7NLwl17LHufHDfA\&q=85\&s=fd3eadc586ec840bae6bf282098923b3)

> [!TIP]
>
> Running several websites from one database? Keys and defaults are stored per website. Pick the website at the top of the Settings page and configure each one.

## Artwork after checkout

The module lets customers pay first and upload their artwork later, on your own upload page. See [Artwork after checkout](https://filecheck.io/docs/configuration/artwork-after-checkout.md) for the whole feature.

**1. Set up your upload page**

In Filecheck, go to **Settings → Artwork after checkout**, set an **Upload Page Address**, and add your logo and colours.

**2. Choose when to collect artwork**

In the Filecheck section of the website settings, set **Collect Artwork** for the whole store: **Before Add to Cart** (at checkout), **Before or after checkout** (optional, or after checkout) or **After checkout** (after checkout only). To change one product, use **Collect Artwork** on the product's **Filecheck** tab. The module's setting decides both the product page and which order lines wait for artwork.

**3. Choose how customers get the link**

The link shows on the order confirmation page and on the customer's order page in their portal. With **Email the Upload Link** on, customers also get one **Upload your artwork** email when the order is confirmed. Edit its wording in the **Filecheck: Upload your artwork** email template.

Files customers upload on the upload page land on their order lines in Odoo within about 30 minutes, and are saved on the order like any other.

> [!NOTE]
>
> Only confirmed sales orders get an upload page: quotations and cancelled orders never do. If the upload cannot run on the product page (for example when Filecheck cannot be reached), the customer can still order. That line then waits for artwork after checkout, and the customer gets the upload link, whatever the product's setting.

> [!TIP]
>
> How the module talks to Filecheck, for developers: see the [Odoo reference](https://filecheck.io/docs/integrations/odoo.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.