Feature Guides

Detailed step-by-step walkthroughs for every major feature in SweepTag.

Table of Contents

  1. Local Databases
  2. Adding Assets
  3. Custom Fields
  4. Barcode Generation
  5. Barcode Scanning
  6. Printing Labels
  7. File Organization
  8. Lansweeper Integration
  9. Multi-Database Management
  10. Exporting Data

Local Databases

Creating a Local Database

A local database is your own inventory system. Use it for tools, equipment, personal items, or small business assets.

Steps:

  1. Open the app and go to Home tab (if first time, you'll see the setup wizard)
  2. Tap "Add Database" button in the center
  3. Choose a template (or start blank):
    • IT Equipment: Fields for hostname, OS, IP, warranty, owner
    • Tools: Fields for category, location, condition, value
    • AV Gear: Fields for resolution, input types, location
    • Furniture: Fields for condition, location, notes
    • Blank: No predefined fields (you'll add your own)
  4. Name your database (e.g., "Lab Equipment" or "Company Tools")
  5. Tap "Create"

Your database is ready! You can now add assets (see Adding Assets).

Managing Multiple Databases

Once you have multiple databases, you can switch between them easily.

To switch databases:

  1. Go to Assets tab
  2. Tap the database name at the top (shows current database)
  3. Select a different database from the list
  4. All assets displayed are now from the selected database

To delete a database:

  1. Go to Assets tab → Select database
  2. Tap the settings icon (⚙️) next to the database name
  3. Tap "Delete Database"
  4. Confirm (this cannot be undone)

To rename a database:

  1. Go to Assets tab → Select database
  2. Tap the settings icon (⚙️)
  3. Tap "Edit Database"
  4. Change the name
  5. Tap "Save"

Note: Each database is completely independent. Barcodes generated for one database won't appear in another.

Adding Assets

Add a Single Asset

Steps:

  1. Go to Assets tab
  2. Select your database (if multiple exist)
  3. Tap the "+" button at the top right
  4. Fill in the fields:
    • Name (required): Asset name (e.g., "ThinkPad X1")
    • Other fields: Depends on your database template (hostname, serial number, location, etc.)
    • Use dropdown fields: Tap to select from predefined options
    • Use date fields: Tap to open calendar
  5. Tap "Save"

Your asset is created! It appears in the asset list.

Bulk Add Assets (Import)

If you have many assets, you can import them from CSV.

Steps:

  1. Prepare a CSV file with your asset data: 
    Name,Category,Location,Value
Hammer,Hand Tools,Shed,$35
Power Drill,Power Tools,Garage,$120
Ladder,Large Items,Garage,$75
  2. In Assets tab, select your database
  3. Tap "Import" button
  4. Select your CSV file
  5. SweepTag maps columns to your database fields
  6. Tap "Import"

All assets are imported into your database at once.

Edit an Asset

Steps:

  1. Go to Assets tab → Select database
  2. Tap the asset you want to edit
  3. Tap "Edit" button
  4. Modify any fields
  5. Tap "Save"

Delete an Asset

Steps:

  1. Go to Assets tab → Select database
  2. Swipe left on the asset (or long-press)
  3. Tap "Delete"
  4. Confirm

Bulk Edit Assets

Edit multiple assets at once.

Steps:

  1. Go to Assets tab → Select database
  2. Tap "Select" button (top right)
  3. Tap to select multiple assets (checkboxes appear)
  4. Tap "Edit Selected" button
  5. Choose which field to update (e.g., "Location")
  6. Enter the new value (e.g., "Warehouse B")
  7. Tap "Apply"

All selected assets are updated with the new value.

Custom Fields

What are Custom Fields?

Custom fields let you store any data you want about your assets. SweepTag supports 9 field types:

Field TypePurposeExample
TextShort text (single line)"Serial number", "Model"
MultilineLong text (multiple lines)"Notes", "Description"
NumberNumeric values"Purchase price", "Quantity"
DateCalendar dates"Purchase date", "Warranty expiration"
ChoiceDropdown options"Status" (New/Used/Damaged), "Department" (HR/IT/Finance)
URLWeb links"Product page", "Manual link"
EmailEmail addresses"Owner email", "Support email"
PhonePhone numbers"Vendor support", "Asset owner phone"
CheckboxTrue/False toggle"Under warranty?", "Recently serviced?"

Adding Custom Fields to a Database

Steps:

  1. Go to Assets tab → Select database
  2. Tap database name → "Edit Database"
  3. Scroll to "Custom Fields" section
  4. Tap "Add Field"
  5. Enter the field name (e.g., "Serial Number")
  6. Choose the field type (e.g., Text)
  7. If Choice field: Add your options (e.g., "New", "Used", "Damaged")
  8. Tap "Save"

Your field is added! It now appears when you create or edit assets.

Organizing Fields with Groups

Group related fields together for better organization (e.g., all warranty fields together).

Steps:

  1. In Edit Database → Custom Fields
  2. Tap "Add Group"
  3. Enter group name (e.g., "Warranty Information")
  4. Add fields to the group by selecting them
  5. Fields in a group appear together when editing assets

Barcode Generation

Generate a Barcode for a Single Asset

Steps:

  1. Go to Assets tab → Select your asset
  2. Tap "Generate Barcode" button
  3. In the barcode options screen:
    • Format: Choose QR Code or Code 128
    • Link type: Choose what the barcode encodes:
      • Asset Key: Unique ID (default)
      • Custom Field: Value from any custom field (e.g., serial number)
      • Custom URL: Any URL (e.g., https://yoursite.com/assets/{id})
  4. Tap "Generate"
  5. Barcode preview appears

From the preview, you can:

  • Print: Tap print icon to send to printer
  • Share: Tap share icon to email, message, or save
  • Copy: Long-press to copy barcode image

Generate Barcodes for Multiple Assets

Steps:

  1. Go to Codes tab
  2. Select your database (shows all unbarcoded assets)
  3. Tap "Select All" or manually select specific assets
  4. Tap "Generate All" button
  5. Confirm barcode options (format, link type)
  6. SweepTag generates all barcodes (progress bar shows)
  7. Barcodes appear in a list when done

You can now:

  • Print them all at once
  • Organize them by folder (see File Organization)
  • Export to files

QR Code vs Code 128: Which to Use?

QR Code:

  • ✅ Encodes URLs and full asset data
  • ✅ Scannable with any smartphone camera
  • ✅ Larger but encodes more information
  • ✅ Great for linking to external systems
  • Best for: Customer-facing assets, quick linking, modern workflows

Code 128:

  • ✅ Compact barcode format
  • ✅ Scannable with dedicated barcode scanners
  • ✅ Better for high-volume scanning (warehouses, retail)
  • ✅ Narrower format fits small labels
  • Best for: High-volume scanning, thermal label printing

Configuring Default Barcode Options

Set defaults so you don't have to choose every time.

Steps:

  1. Go to Settings tab → Barcode Configuration
  2. Choose your default format (QR or Code 128)
  3. Choose your default link type (what the barcode encodes)
  4. Choose your default file format (PNG, JPEG, SVG, or PDF)
  5. Tap "Save"

Every future barcode uses these defaults (you can still override per-barcode).

Barcode Scanning

Scan Your First Barcode

Steps:

  1. Go to Scan tab
  2. Tap to open camera
  3. Point at any barcode (QR code, Code 128, etc.)
  4. App automatically detects and decodes the barcode
  5. Barcode data appears:
    • What was scanned (asset name, URL, phone number, etc.)
    • Timestamp of scan
    • Scan classification (Asset, URL, Contact, etc.)

From the scan result, you can:

  • View full asset details (if it's an asset in your system)
  • Open the link (if it's a URL)
  • Save the contact (if it's a phone number or email)
  • View scan history for this asset

View Scan History

Track all your scans over time.

Steps:

  1. Go to Home tab
  2. Scroll to "Recent Scans" section
  3. See scans from the last 7 days with:
    • Asset name or description
    • Date and time
    • Scan type (Asset, URL, Contact, etc.)

Tap any scan to see full details.

Search Scan History

Find a specific scan.

Steps:

  1. Go to Scan tab
  2. Tap search icon 🔍
  3. Type asset name or description
  4. Matching scans appear

Activity Chart

Visualize your scanning activity.

Steps:

  1. Go to Home tab
  2. View "Scans This Week" chart
  3. See bar graph of scans per day (last 7 days)
  4. Tap a day to see details

Use cases:

  • Audit verification: "Did we scan all assets in Building A on Monday?"
  • Workload tracking: "How many items did I scan this week?"

Printing Labels

Print a Barcode Label

Steps:

  1. Generate a barcode (see Barcode Generation)
  2. In the barcode preview, tap print icon 🖨️
  3. Choose print options:
    • Size: Small (48×30mm), Medium (70×45mm), or Large (100×60mm)
    • Content: Barcode only, or include name/value/date
  4. Tap "Print"
  5. Choose your printer (AirPrint or network printer)
  6. Confirm print settings (copies, paper size, etc.)
  7. Tap "Print" on printer selection screen

Your label prints!

Print Multiple Labels at Once

Steps:

  1. Go to Codes tab → Select multiple barcodes
  2. Tap "Print All" button
  3. Choose size and content (same as single print)
  4. All barcodes print on label sheets
  5. Cut and apply to assets

Print Settings

Configure default print preferences.

Steps:

  1. Go to Settings tab → Print Settings
  2. Choose your default print size (Small, Medium, Large)
  3. Choose your default content (Barcode only, or with name/value/date)
  4. Set paper size (for auto-scaling)
  5. Tap "Save"

All future prints use these defaults.

Label Size Reference

SizeDimensionsUse Case
Small48 × 30 mm (2" × 1.2")Small items, efficient use of label sheets
Medium70 × 45 mm (2.8" × 1.8")Standard assets (laptops, monitors)
Large100 × 60 mm (3.9" × 2.4")Large items, easy scanning in warehouses

Printing Requirements

  • Printer: AirPrint-compatible (iOS) or network printer (Android)
  • Labels: Thermal label rolls (4" × 6" recommended) or label sheet paper
  • Quality: 203+ DPI for best barcode readability
  • Connectivity: Printer must be on same Wi-Fi network

File Organization

What is the File View?

The File View organizes all your barcodes into a virtual folder structure (like a file system). This helps you find and manage barcodes by category.

Example structure:

Codes/
  Local Database (My Tools)/
    Hand Tools/
      hammer.png
      saw.png
    Power Tools/
      drill.png
      sander.png
  Lansweeper (Office Site)/
    Servers/
      server-01.png
      server-02.png
    Workstations/
      workstation-01.png

View File Organization

Steps:

  1. Go to Codes tab
  2. Toggle view mode: Tap the folder icon (top right) to switch from List to Files
  3. All barcodes now appear organized by database and grouping

Configure File Organization

Control how barcodes are grouped and named.

Steps:

  1. Go to Settings tab → File Structure
  2. Configure:
    • Group by: Flat (no folders), By Format (QR/Code128), or By Field (e.g., asset type)
    • File naming: Choose which asset fields to include in filename
    • File format: PNG, JPEG, SVG, or PDF
  3. Tap "Save"

All barcodes automatically reorganize using your new structure.

Search Across All Barcodes

Find a barcode quickly.

Steps:

  1. Go to Codes tab (any view mode)
  2. Tap search icon 🔍
  3. Type part of the asset name (e.g., "ThinkPad" or "printer")
  4. Matching barcodes appear instantly

Lansweeper Integration

Connect Your Lansweeper Instance

Prerequisites:

  • Lansweeper account with at least one site
  • Lansweeper API access (not available on free tier)
  • Personal Access Token (PAT) from Lansweeper

Steps:

  1. In Lansweeper, go to Settings › API & Webhooks
  2. Generate a Personal Access Token (copy it)
  3. In SweepTag, go to Settings tab → Integrations › Lansweeper
  4. Tap "Add Connection"
  5. Paste your Lansweeper API URL (found in Lansweeper settings)
  6. Paste your Personal Access Token
  7. Tap "Connect"

SweepTag auto-discovers all sites authorized by your PAT.

You're connected! You can now browse and barcode your Lansweeper assets.

Browse Lansweeper Assets

Steps:

  1. Go to Assets tab
  2. Select "Lansweeper" (in the database list)
  3. Select a site (if you have multiple)
  4. Browse all assets or use search to find specific ones
  5. Tap an asset to see full details (10+ sections):
    • Overview (name, type, OS, owner)
    • Hardware info
    • Network info
    • Software inventory
    • Security (CVEs, vulnerabilities)
    • Lifecycle (warranty, purchase date)
    • And more...

Search Lansweeper Assets

Find specific assets quickly.

Steps:

  1. Go to Assets tab → Select Lansweeper
  2. Tap search icon 🔍
  3. Type asset name, hostname, or other property
  4. Matching assets appear instantly (live search)

Generate Barcode for Lansweeper Asset

Steps:

  1. Open an asset detail (see above)
  2. Tap "Generate Barcode" button
  3. Choose options:
    • Format: QR or Code 128
    • Link type:
      • Asset Key: Encodes the asset's unique ID
      • Lansweeper URL: Direct link to asset in Lansweeper
      • Custom URL: Your own URL pattern
  4. Tap "Generate"

Barcode preview appears (print or share from here).

Create Custom Field in Lansweeper

Some Lansweeper fields are read-only on cloud assets. SweepTag lets you create custom text fields to store barcode values.

Steps:

  1. In SweepTag, go to Settings › Lansweeper
  2. Tap "Create Custom Field"
  3. Name it (e.g., "Barcode ID")
  4. SweepTag creates the field in all connected sites
  5. Field now appears in Lansweeper as a writable custom field

Tip: When generating barcodes, configure them to write back to this field for automatic tracking in Lansweeper.

Configure Lansweeper Barcode Defaults

Set up how all Lansweeper barcodes encode.

Steps:

  1. Go to Settings › Lansweeper
  2. Choose barcode format (QR or Code 128)
  3. Choose link type (Asset Key, Lansweeper URL, or Custom URL)
  4. If custom URL: Enter pattern (e.g., https://yourcompany.com/assets/{id})
  5. Tap "Save"

All Lansweeper barcodes use these defaults.

Sync Asset Data from Lansweeper

Update your local cache of Lansweeper assets.

Steps:

  1. Go to Assets tab → Select Lansweeper
  2. Tap refresh icon 🔄
  3. SweepTag fetches latest assets from Lansweeper
  4. Progress bar shows sync status

Tip: Syncs happen automatically when online, but you can force a refresh anytime.

Multi-Database Management

Add Multiple Local Databases

You can create many local databases for different purposes.

Steps:

  1. Go to Home tab
  2. Tap "Add Database" button
  3. Follow the same process as before (choose template, name, create)
  4. Repeat for each database you need

Switching databases: Go to Assets tab, tap database name, select a different one.

Add Multiple Lansweeper Connections

Connect to multiple Lansweeper instances or use different PAT tokens.

Steps:

  1. Go to Settings › Integrations › Lansweeper
  2. Tap "Add Connection" (if one already exists)
  3. Paste new API URL and PAT
  4. Tap "Connect"

You can now have:

  • Multiple Lansweeper instances (e.g., prod + staging)
  • Different PAT scopes (e.g., regional accounts)
  • Multiple sites from different PATs

View All Databases at Once (Home)

Get an overview of all your databases.

Steps:

  1. Go to Home tab

  2. See "Assets & Barcodes" widget showing:

    • Total databases
    • Total assets
    • Total barcoded assets
    • Breakdown per database

  3. Tap any database to jump to it

Organize and Switch Between Databases

Quick switch in Assets tab:

  1. Tap the database name at the top
  2. Select a different database from the dropdown

Delete a database:

  1. Select the database
  2. Tap settings icon (⚙️)
  3. Tap "Delete"

Exporting Data

Export Barcodes as Files

Export generated barcodes to use elsewhere.

Steps:

  1. Go to Codes tab → Select barcodes you want to export
  2. Tap "Export" button
  3. Choose:
    • Format: PNG, JPEG, SVG, or PDF
    • Selection: All, selected, or by database
  4. Tap "Export"
  5. Files are saved and ready to download/share

Export Asset Data as CSV

Export your assets to spreadsheet format.

Steps:

  1. Go to Assets tab → Select database
  2. Tap export icon 📊
  3. Choose CSV format
  4. Tap "Export"
  5. File downloads to your device

You can now:

  • Open in Excel or Google Sheets
  • Perform calculations
  • Share with team members
  • Backup your data

Export Scan History

Export all your scans for reporting.

Steps:

  1. Go to Home tab → "Scan History"
  2. Tap export icon
  3. Choose format: CSV or JSON
  4. Tap "Export"
  5. File downloads

Use for:

  • Audit reports
  • Compliance documentation
  • Sharing with team
  • Data analysis

Share Barcode Files

Send barcodes to others via email or messaging.

Steps:

  1. Generate or select a barcode
  2. Tap share icon 📤
  3. Choose how to share:
    • Email: Sends barcode image as attachment
    • Messages: SMS or iMessage
    • Save to Photos: Saves to device photos
    • Cloud services: Google Drive, OneDrive, etc.

Advanced Features

Deep Linking (Scan to Asset)

When you scan a barcode generated by SweepTag, the app automatically opens the asset detail.

Example:

  1. You scan a barcode (QR code linking to sweeptag://asset/12345)
  2. SweepTag automatically opens and displays that asset
  3. Shows full details: name, fields, history, etc.

Offline Mode

SweepTag works fully offline. Changes sync when you're back online.

What works offline:

  • ✅ Scanning barcodes
  • ✅ Viewing cached asset data
  • ✅ Generating new barcodes
  • ✅ Printing labels
  • ✅ Editing local assets

What requires internet:

  • ❌ Browsing fresh Lansweeper data
  • ❌ Creating Lansweeper custom fields
  • ❌ Writing back to Lansweeper

Tip: Before visiting a site with no internet, open Lansweeper to cache the data.

Cache Management

Control how much asset data is cached locally.

Steps:

  1. Go to Settings › Advanced
  2. Choose cache refresh interval (how often to auto-sync Lansweeper data)
  3. Tap "Clear Cache" to free up space
  4. Tap "Save"

Theme & Appearance

Customize the app look.

Steps:

  1. Go to Settings › Appearance
  2. Choose theme: Light, Dark, or System
  3. Tap "Save"

Swipe Actions

Configure what happens when you swipe left/right on an asset.

Steps:

  1. Go to Settings › Swipe Actions
  2. Choose actions for swipe left and swipe right
  3. Options: Delete, Generate Barcode, View Details, etc.
  4. Tap "Save"

Troubleshooting

Barcode won't generate?

  • Ensure the asset has a name (required field)
  • Check that you have free storage space on device

Printer not found?

  • Ensure printer is on same Wi-Fi network
  • Try restarting printer
  • Use AirPrint on iOS, network printer on Android

Lansweeper connection fails?

  • Verify PAT is still valid (may have expired)
  • Check internet connection
  • Ensure Lansweeper instance is accessible

Scans not logging?

  • Verify Scan tab has camera permission
  • Check that you're pointing at a readable barcode
  • Try with a different barcode or QR code

See FAQ for more troubleshooting.