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

# Setting Up Invoice Generator

Before your team can start using Invoice Generator, an administrator must complete the Setup Wizard. This is a one-time process that verifies your permissions and activates the add-on.

<Note>
  The Setup Wizard checks for two platform permissions: **View flows** and **View tasks**. Make sure your role has these before starting.
</Note>

## Starting the Setup Wizard

When you open Invoice Generator for the first time, the Setup Wizard appears automatically.

<div align="center">
  <img src="https://mintcdn.com/mileapp-e5b5ea5a/AQ4dlswnHi-T9MHD/images/add-on/invoice-generator/wizard-welcome.png?fit=max&auto=format&n=AQ4dlswnHi-T9MHD&q=85&s=b8478e0c122a6a7693fcd1a0f79f8374" alt="Setup Wizard welcome screen" width="600" data-path="images/add-on/invoice-generator/wizard-welcome.png" />
</div>

<p><em>The Setup Wizard opens automatically on first access, showing 3 steps: Welcome, Permissions, and Review.</em></p>

## Step 1: Welcome

The welcome screen explains the main features of Invoice Generator:

* Drag-and-drop template designer with live preview
* Text, Image, Barcode, QR Code, Table, and shape elements
* Pull task data from flows and insert dynamic variables
* Export and import templates as JSON, print or export as PDF

It also describes what will be configured:

* Verify your account permissions
* Review and activate the add-on
* Create page-level access permissions (Builder, Task List)

Click **Continue** to proceed.

## Step 2: Verify Permissions

The wizard checks that your account has the required platform permissions.

<div align="center">
  <img src="https://mintcdn.com/mileapp-e5b5ea5a/AQ4dlswnHi-T9MHD/images/add-on/invoice-generator/wizard-permissions.png?fit=max&auto=format&n=AQ4dlswnHi-T9MHD&q=85&s=a3edfff14c9ec114b2b0a4d121cf3212" alt="Permissions step" width="600" data-path="images/add-on/invoice-generator/wizard-permissions.png" />
</div>

<p><em>The Permissions step shows a checklist. All items must be granted before you can continue.</em></p>

| Category | Permission |
| -------- | ---------- |
| **Flow** | View flows |
| **Task** | View tasks |

If any permission is missing, contact your administrator to update your role in the Permission page. Click **Recheck** after permissions are updated.

Click **Continue** to proceed.

## Step 3: Review and Activate

The Review step shows a summary of all configurations. Verify everything looks correct.

<div align="center">
  <img src="https://mintcdn.com/mileapp-e5b5ea5a/AQ4dlswnHi-T9MHD/images/add-on/invoice-generator/wizard-review.png?fit=max&auto=format&n=AQ4dlswnHi-T9MHD&q=85&s=8469028b27e639612b64273ba5eef441" alt="Review step" width="600" data-path="images/add-on/invoice-generator/wizard-review.png" />
</div>

<p><em>The Review step confirms all permissions are granted and the add-on is ready to activate.</em></p>

Click **Activate Addon** to finish setup. The Builder page loads immediately.

## Page-Level Permissions

After setup, the wizard creates two custom permissions for your organization:

| Permission         | Controls access to              |
| ------------------ | ------------------------------- |
| **View Builder**   | The template designer page      |
| **View Task List** | The task list and printing page |

These permissions are automatically granted to the user who completes the wizard. To give other users access, go to **Settings > Permission** and enable these permissions under the add-on's section.

<div align="center">
  <img src="https://mintcdn.com/mileapp-e5b5ea5a/AQ4dlswnHi-T9MHD/images/add-on/invoice-generator/no-access.png?fit=max&auto=format&n=AQ4dlswnHi-T9MHD&q=85&s=ec47be5d90ae317a68f9a1afedd17a7c" alt="No access page" width="600" data-path="images/add-on/invoice-generator/no-access.png" />
</div>

<p><em>Users without the required permission see the standard MileApp access denied page.</em></p>

## Deleting Configuration

To reset the add-on and start over:

1. Click the **gear icon (⚙)** in the Builder toolbar.
2. Select **Delete Configuration**.
3. Confirm the action in the popup dialog.

This resets the add-on configuration but does **not** delete your saved templates or the custom permissions. Templates remain in the library and can be reused after re-running the wizard.
