Configuration Reference

Complete guide to all SweepTag settings and customization options.

Barcode Configuration

Barcode Format

Choose how barcodes are generated.

Location: Settings › Barcode Configuration › Format

Options:

  • QR Code (default)

    • Encodes: Full URLs, asset data, text
    • Scannable: Any smartphone camera or barcode scanner
    • Size: Varies by data (small to large)
    • Best for: Quick linking, mobile scanning

  • Code 128

    • Encodes: Numbers and basic text
    • Scannable: Dedicated barcode scanners
    • Size: Narrow horizontal bars
    • Best for: Warehouse scanning, dense labels

Barcode Link Type

Configure what the barcode encodes when scanned.

Location: Settings › Barcode Configuration › "Barcodes link to"

Options:

Asset Key (Default)

  • Encodes: Unique identifier (e.g., asset-12345)
  • When scanned: App looks up asset by ID
  • Example: SweepTag can show full asset details from internal database
  • Use for: Internal tracking, app-based workflows

Lansweeper URL

  • Encodes: Direct link to Lansweeper (e.g., https://app.lansweeper.com/asset/12345)
  • When scanned: Opens Lansweeper in browser, shows asset detail
  • Use for: Lansweeper-centric workflows, direct asset viewing
  • Available for: Lansweeper assets only

Custom URL

  • Encodes: Your own URL pattern
  • Template: https://yoursite.com/assets/{assetKey}
  • When scanned: Opens your custom URL in browser
  • Placeholders:
    • {assetKey} - Asset's unique ID
    • {id} - Same as assetKey
  • Example: https://inventory.company.com/lookup?id={id}
  • Use for: Custom systems, external tools, web dashboards

Custom Field Value

  • Encodes: Value from a custom field (local databases only)
  • Example: Encode serial number, barcode number, or SKU
  • When scanned: Displays the field value
  • Available for: Local database assets with custom fields
  • Use for: Encoding product codes, serial numbers, internal IDs

File Format

Choose the image format for generated barcodes.

Location: Settings › Barcode Configuration › File format

Options:

  • PNG (default)

    • Format: Lossless image
    • Size: Larger file size
    • Quality: Perfect for printing
    • Transparency: Supported
    • Best for: General use, printing

  • JPEG

    • Format: Lossy compressed image
    • Size: Smaller file size
    • Quality: Good for printing
    • Warning: Compression can blur barcode edges
    • Best for: Web use, sharing via email

  • SVG

    • Format: Vector graphics (scalable)
    • Size: Smallest file size
    • Quality: Perfect at any scale
    • Scalable: Infinitely without quality loss
    • Best for: Professional printing, large formats

  • PDF

    • Format: Document format
    • Size: Includes metadata
    • Printable: Direct from PDF readers
    • Best for: Bulk printing, archival

Note: PDF has compression similar to JPEG. For barcode scanning, PNG or SVG is recommended to avoid edge blur.

File Structure

Control how generated barcodes are organized into a virtual file system.

Location: Settings › File Structure

File Naming

Configure how barcode filenames are constructed.

Components you can include:

  • Asset Name: Name from asset record
  • Asset ID: Unique identifier
  • Serial Number: From custom field (if available)
  • Database: Name of the database
  • Type: Asset type or category
  • Custom fields: Any field from your asset schema

Example naming:

  • Simple: {name}.png → ThinkPad X1.png
  • With ID: {name}_{id}.png → ThinkPad X1_asset-12345.png
  • With serial: {name}_{serial}.png → ThinkPad X1_SN12345.png

To configure:

  1. Go to Settings › File Structure › File Naming
  2. Select fields to include in order (drag to reorder)
  3. Choose separator between fields: _ (underscore), - (dash), or ␣ (space)
  4. Tap "Save"

Folder Organization

Control how barcodes are grouped into folders.

Location: Settings › File Structure › Folders

Options:

Flat (Default)

  • No folder grouping
  • All barcodes in root
  • Use for: Simple collections, fewer than 100 items

By Format

  • Separate folders: QR Code/ and Code 128/
  • Groups by barcode type
  • Use for: Workflows that generate both formats

By Asset Type

  • Separate folders for each asset type
  • Example: Servers/, Workstations/, Printers/
  • Use for: Large inventories with multiple types
  • Lansweeper: Default setting (Lansweeper has asset type field)

By Custom Field

  • Choose a custom field (e.g., "Department", "Category", "Location")
  • Creates folder per field value
  • Example: Marketing/, IT/, Finance/
  • Use for: Organizing by department, location, team, etc.
  • Local only: Requires custom field on your assets

File Format

Choose image format for all generated barcodes.

(See Barcode Format above for details on PNG, JPEG, SVG, PDF)

Lansweeper Configuration

Connection Settings

Manage your Lansweeper instance(s).

Location: Settings › Integrations › Lansweeper

Add a connection:

  1. Tap "Add Connection"
  2. Enter Lansweeper API URL (found in Lansweeper › Settings › API)
  3. Provide Personal Access Token (PAT)
  4. Tap "Connect"

Multiple connections:

  • You can add multiple Lansweeper instances
  • Each uses its own PAT
  • Useful for: Different regions, staging vs. production, multi-tenant

Remove a connection:

  1. Select the connection
  2. Tap "Remove"
  3. Confirm

Custom Field Configuration

Configure how barcode values are written back to Lansweeper.

Location: Settings › Lansweeper › Custom Field

Create a custom field:

  1. Tap "Create Custom Field"
  2. Name it (e.g., "Barcode ID")
  3. SweepTag creates the field on all connected sites
  4. Field becomes writeable for custom barcode values

Use cases:

  • Store barcode values in Lansweeper for auditing
  • Track which barcodes are assigned to which assets
  • Link Lansweeper records to external barcode systems

Barcode Format for Lansweeper

Same as Barcode Format above (QR, Code 128).

Location: Settings › Lansweeper › Barcode Format

Link Type for Lansweeper

Same as Barcode Link Type above.

Location: Settings › Lansweeper › "Barcodes link to"

Available options for Lansweeper:

  • Asset Key
  • Lansweeper URL
  • Custom URL (with {id} placeholder)

Print Settings

Default Print Size

Set your default label size.

Location: Settings › Print Settings › Size

Options:

  • Small: 48 × 30 mm (2" × 1.2")

    • Efficient use of label sheets
    • Fits on smaller items

  • Medium: 70 × 45 mm (2.8" × 1.8")

    • Standard asset labels
    • Default for most use cases

  • Large: 100 × 60 mm (3.9" × 2.4")

    • Large items, warehouses
    • Easy to scan
    • Easy to read

Default Print Content

Choose what appears on printed labels.

Location: Settings › Print Settings › Content

Options:

  • Barcode only (default)

    • Just the barcode image
    • Minimal label space
    • Clean, professional look

  • Barcode + Name

    • Barcode + asset name text
    • Helps identify item visually

  • Barcode + Value

    • Barcode + the encoded value (e.g., asset ID)
    • Useful for manual lookup

  • Full Label

    • Barcode + name + value + generation date
    • Maximum information on one label
    • Useful for auditing and tracking

Paper Size

Set your default paper size (for scaling).

Location: Settings › Print Settings › Paper Size

Options:

  • 4" × 6" (thermal label default)
  • Letter (8.5" × 11")
  • A4
  • Custom: Enter your paper dimensions

Cache & Sync

Cache Refresh Interval

Control how often cached Lansweeper data is refreshed.

Location: Settings › Advanced › Cache Refresh Interval

Options:

  • 1 hour - Updates very frequently
  • 4 hours (default)
  • 12 hours
  • 24 hours
  • Manual only - Never auto-refresh

Use cases:

  • Hourly: Rapidly changing assets (testing, rapid deployments)
  • 4 hours: Balanced (most users)
  • 24 hours: Stable environments, minimize network traffic
  • Manual: Maximum control, offline-first workflows

Clear Cache

Free up local storage by removing cached data.

Location: Settings › Advanced › Clear Cache

What's cleared:

  • Cached Lansweeper asset lists
  • Asset detail pages
  • Search results

What's NOT cleared:

  • Local database assets
  • Barcode history
  • Scan history
  • Settings

Use when:

  • Running out of device storage
  • Want to force fresh data sync
  • Troubleshooting sync issues

Appearance & Theme

Theme Selection

Choose the app's visual appearance.

Location: Settings › Appearance › Theme

Options:

  • Light - Bright white background, dark text
  • Dark - Dark background, light text
  • System - Follows device's system theme preference

Accent Color

Choose the app's primary accent color.

Location: Settings › Appearance › Accent Color

Options:

  • Orange (default) - Warm, professional
  • Blue - Cool, tech-focused
  • Green - Natural, environmental
  • Purple - Creative, modern

Swipe Actions

Configure what happens when you swipe left or right on an asset in the list.

Location: Settings › Swipe Actions

Left Swipe: Quick action for the left direction Right Swipe: Quick action for the right direction

Available actions:

  • View Details - Open asset detail page
  • Generate Barcode - Create barcode for asset
  • Edit - Open asset for editing
  • Delete - Remove asset (with confirmation)
  • Duplicate - Create a copy of asset
  • Favorite - Mark asset as favorite

Customize:

  1. Go to Settings › Swipe Actions
  2. Tap "Left Swipe" or "Right Swipe"
  3. Choose your action
  4. Tap "Save"

Examples:

  • Left swipe → Delete
  • Right swipe → Generate Barcode
  • Or configure based on your workflow

Advanced Settings

Debug Mode

Enable detailed logging for troubleshooting.

Location: Settings › Advanced › Debug Mode

When enabled:

  • App logs detailed activity (network calls, errors, state changes)
  • Accessible in Settings › Debug › View Logs
  • Helps diagnose connection issues, data sync problems

Use when:

  • Troubleshooting Lansweeper connection issues
  • Reporting bugs to support
  • Investigating unexpected behavior

Debug Logs

View and export detailed app logs.

Location: Settings › Advanced › Debug Logs

Available actions:

  • View: See recent log entries
  • Export: Send logs via email/file for analysis
  • Clear: Remove old logs to free space

Offline Indicator

Shows your current connectivity status.

Location: Top of app (various screens)

Statuses:

  • Online (blue) - Connected to internet
  • Offline (gray) - No internet connection

Note: App functions normally offline; changes sync when online

Local Database Settings

Database Name

Change the name of your local database.

Location: Assets tab › Select database › Settings ⚙️ › Edit Database › Name

Database Template

View which template your database was created from.

Location: Assets tab › Select database › Settings ⚙️ › Info

Export Database

Export all assets as CSV or JSON.

Location: Assets tab › Select database › Export

Formats:

  • CSV - Open in Excel, Google Sheets
  • JSON - For data migration, backups

Delete Database

Permanently remove a local database.

Location: Assets tab › Select database › Settings ⚙️ › Delete Database

Warning: This cannot be undone. All assets and barcodes are deleted.

App-Wide Settings

Language

Set app language (if available).

Location: Settings › Language

Default: System language

Notifications

Enable/disable app notifications.

Location: Settings › Notifications

Types:

  • Barcode generation alerts
  • Sync status notifications
  • Custom field update confirmations

About

View app version and build information.

Location: Settings › About

Includes:

  • App version number
  • Build number
  • Device information
  • Installed features

Default vs. Per-Item Configuration

Many settings have two levels:

App-Wide Default

  • Set once in Settings
  • Applies to all future barcodes/items
  • Example: Default barcode format = QR Code

Per-Item Override

  • Override the default for a specific barcode or asset
  • Takes precedence over app default
  • Example: Generate a Code 128 barcode even if default is QR

Workflow:

  1. Set app-wide default in Settings (saves time)
  2. Override per-item when needed (flexibility)

Configuration Examples

Example 1: Warehouse Inventory (High-Volume Scanning)

Recommended Settings:

  • Barcode Format: Code 128 (faster scanning)
  • Folders: By Location (organize by warehouse section)
  • File Naming: Asset name + Item ID
  • Print Size: Large (easy to scan in warehouse)
  • Print Content: Barcode + Name
  • Cache Refresh: Manual (stable inventory)

Example 2: IT Asset Management (Lansweeper)

Recommended Settings:

  • Barcode Format: QR Code (smartphone-friendly)
  • Link Type: Lansweeper URL (direct to system)
  • Folders: By Asset Type (Servers, Workstations, Printers)
  • File Naming: Asset Name + Serial Number
  • Print Size: Medium (standard labels)
  • Print Content: Barcode + Name
  • Cache Refresh: 4 hours (automatic sync)

Example 3: Tool Library (Small Collection)

Recommended Settings:

  • Barcode Format: QR Code (smartphone check-out)
  • Folders: Flat or By Category
  • File Naming: Tool Name
  • Print Size: Small (efficient sheets)
  • Print Content: Barcode only
  • Swipe Actions: Right = Checkout, Left = View Details

Example 4: Quick Barcode Generation (Hobbyist)

Recommended Settings:

  • Barcode Format: QR Code (versatile)
  • Link Type: Custom URL (to your site)
  • File Format: SVG (scalable)
  • Print Size: Small (space-efficient)
  • Print Content: Barcode only

Factory Reset

Reset all settings to defaults.

Location: Settings › Advanced › Factory Reset

What's reset:

  • All settings (barcode, print, file structure)
  • Theme and appearance
  • Swipe actions
  • Cache preferences

What's NOT reset:

  • Local database content
  • Barcode history
  • Scan history
  • Lansweeper connections (you may need to re-add)

Use when:

  • Troubleshooting configuration issues
  • Starting over with a clean slate
  • Resolving conflicts after app updates

Warning: Use cautiously. Settings changes are lost.

Saving Configuration as Template

(Planned feature)

In a future update, you'll be able to save your configuration as a template and share it with team members or use it across devices.