> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mileapp.dev/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-c1584fbc/lT19TBAFfX4u3gQY/images/add-on/invoice-generator/wizard-welcome.png?fit=max&auto=format&n=lT19TBAFfX4u3gQY&q=85&s=b8b55a21d7ddde022e44f4a25112eb68" 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-c1584fbc/lT19TBAFfX4u3gQY/images/add-on/invoice-generator/wizard-permissions.png?fit=max&auto=format&n=lT19TBAFfX4u3gQY&q=85&s=e5e58e924c483e74afed841c98378eae" 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-c1584fbc/lT19TBAFfX4u3gQY/images/add-on/invoice-generator/wizard-review.png?fit=max&auto=format&n=lT19TBAFfX4u3gQY&q=85&s=7bb36f8ead0d6f4533cbb0cc6defcad2" 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-c1584fbc/lT19TBAFfX4u3gQY/images/add-on/invoice-generator/no-access.png?fit=max&auto=format&n=lT19TBAFfX4u3gQY&q=85&s=6b74745c48cf94909c04347ac6ab57c9" 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.