Skip to main content
Before your team can start using Sales Target, an administrator must complete the Setup Wizard. This is a one-time process that configures how the add-on connects to your flows and data.
Required permission:
  • View Sales Target - Manager

Starting the Setup Wizard

When you open Sales Target for the first time, the Setup Wizard appears automatically. The wizard guides you through all the required configuration in six steps.
Setup Wizard welcome screen

The Setup Wizard opens automatically on first access, showing all 7 steps in the left sidebar.

Step 1: Welcome and Permissions

The wizard first checks that your account has the platform permissions needed for the add-on to run. The following permissions are required:
CategoryPermission
FlowView flows
Data TypeView data types
Data TypeCreate data types
Data TypeEdit data types
Data SourceView data records
Data SourceCreate data records
Data SourceEdit data records
Data SourceDelete data records
AutomationView automations
AutomationCreate automations
AutomationEdit automations
OtherView hubs
OtherCreate access tokens
All required permissions must be granted before you can proceed. If any are missing, contact your administrator to update your role in the Permission page.
Permissions step

The Permissions step shows a checklist of required permissions. All items must be granted before you can continue.

Click Next to continue.

Step 2: Select Your Flow and Sales Field

In this step, you connect Sales Target to the flow your sales reps use in the field.
  1. Select a Flow: Choose the flow that captures your sales data. This is typically the flow your reps fill out when visiting a store.
  2. Select the Sales Field: Pick the component in your flow that records product sales. This can be a Bill component (an inline product list) or an Input component connected to a data source.
  3. Select the Store Field (optional): If your flow has a field for the store name, select it here. This allows Sales Target to track targets per store location.
Flow and field selection step

Select the flow, sales field, and store field that Sales Target will use to track achievements.

Only flows with Bill or Data Source components are supported. Make sure your flow is set up before configuring Sales Target.

Step 3: Define Categories

Categories let you break down your sales targets by product group (e.g., Food, Beverages, Personal Care).
  1. Type a category name in the input field and click Add.
  2. Repeat for each product category you want to track.
  3. Categories appear as badges. Click the X on a badge to remove it.
Categories step

Add categories and use the Product Mapping section to assign products to each category.

After adding categories, the wizard will show a product mapping section. Here you assign each product from your flow to a category. Any products not assigned to a category will fall under Uncategorized.
Category names are case-insensitive. You cannot add two categories with the same name (e.g., “Food” and “food”).

Step 4: Configure Data Source

Choose how Sales Target stores its data:
  • Auto-Create (recommended): The wizard automatically creates a data type called Addon-SalesTarget with all the required fields. This is the easiest option.
  • Select Existing: Choose an existing data type that already has the necessary fields. Use this if you want to store target data alongside other information.
Data source configuration step

Choose Auto-Create to let the wizard set up the data type automatically, or select an existing one.

Step 5: Customize Field Labels

Customize the display names used throughout the add-on to match your organization’s terminology:
  • City Label: Default: “Hub”. Change this if your organization uses a different term (e.g., “City”, “Region”, “Area”).
  • Store Label: Default: “Store”. Change this if needed (e.g., “Outlet”, “Branch”, “Location”).
  • Representative Label: Default: “Representative”. Change this if needed (e.g., “Sales Rep”, “Agent”, “Driver”).
These labels will appear on the Manager page, in modals, and in the Excel import/export templates.
Field labels customization step

Customize Hub, Store, and Representative labels to match your organization’s terminology.

Step 6: Review and Save

Review all your configuration choices on the summary page. If everything looks correct, click Save to complete the setup.
Review and activate step

The Review step shows a summary of all your settings. Click Activate Addon to complete setup.

After saving, the Setup Wizard closes and you are taken to the Manager page where you can start creating targets.

Modifying Settings After Setup

You can update your configuration at any time after the initial setup:
  1. Go to the Sales Target Manager page.
  2. Click the gear icon in the top-right corner of the filter bar.
  3. The Settings dialog opens, allowing you to modify categories, field labels, and data source settings.
  4. Click Save to apply your changes.
Add-on configuration settings dialog

The Settings dialog lets you update your flow, categories, and field labels at any time.

Changing categories after targets have been created may affect existing data. Review your changes carefully before saving.