Skip to content

Creating Items

Items are the building blocks of your project - tracking actions, decisions, issues, and questions. This guide shows you all the ways to create them.


What Are Items?

Items come in four types:

Type Purpose Example
Action Tasks to complete "Install electrical panel in building A"
Decision Choices that have been made "Steel foundation was chosen"
Issue Problems to resolve "Water leak in second floor bathroom"
Question Information needed "What's the delivery date for windows?"

Choose Your Method

Different situations call for different approaches. Pick what fits your workflow:

Best for: Office work, detailed items with multiple fields

Time: 2 minutes

When to use: You're at your desk with complete information and want full control over all fields.

Quick steps:

  1. Navigate to Items → Click + New Item
  2. Select type (Action, Decision, Issue, or Question)
  3. Choose project
  4. Enter title and details
  5. Click Create

When you need full control and detailed information.

Detailed Step-by-Step Instructions

Items Page Overview

Items Page

The items page shows all your tasks, with filters and the + New Item button in the top-right corner.

Opening the Form

New Item Button

  1. Click Items in the left sidebar
  2. Look for the + New Item button in the top-right corner
  3. Click to open the creation form

The Creation Form

New Item Form

The form contains all fields needed to create an item. Required fields are marked with an asterisk (*).

Required Fields

1. Select Item Type

Click one of four buttons: - Action - Tasks that need doing - Decision - Choices that have been made - Issue - Problems that need fixing - Question - Information you need

Type Selection

2. Select Project

Click the dropdown to choose which project this item belongs to.

Project Selection

3. Enter Title

Type a clear, descriptive title. - Good: "Water leak at second floor bathroom sink" - Avoid: "Issue" or "Problem"

Title Input

Optional Fields

Description: - Multi-line text area with formatting support - Add specifications, context, or references - Use bullet points for clarity

Due Date: - Click calendar picker - Or type date in YYYY-MM-DD format - Leave blank if no deadline

Due Date Input

Priority: - Low - Can wait, nice-to-have - Medium - Normal workflow (default) - High - Urgent, blocks progress

Priority Selection

Assignee: - Dropdown shows team members - Leave blank for unassigned

Discipline: - Free text field - Example: "Electrical", "Plumbing", "Structural" - Helps route to the right team

Saving

  1. Review all fields
  2. Click Create button
  3. Item appears in the list immediately

Best for: Processing uploaded documents (PDFs, specifications, reports)

Time: 30 seconds per item (after AI processing)

When to use: You've uploaded project documents and want the AI to extract action items automatically.

Quick steps:

  1. Upload documents to project
  2. Wait for AI processing (2-5 minutes)
  3. Review AI-suggested items
  4. Accept, edit, or reject suggestions

Let AI extract items from uploaded documents.

For a complete explanation of document upload, AI processing, reviewing suggestions, and accuracy details, see the Documents Guide →.

Best for: Site visits, meetings, walkthroughs

Time: Automatic during site visit

When to use: You're on site and want to capture multiple observations with voice and photos in one go.

Quick steps:

  1. Tap Reports+ → Start session
  2. Walk around, speak observations, take photos
  3. End session
  4. Review AI-extracted items

Capture an entire site visit with voice, photos, and automatic item extraction.

What are sessions? Sessions bundle multiple observations from one site visit into organized, linked items. Walk around, speak what you see, take photos, and let AI separate it into individual action items.

Session Recording Details

Starting a Session

  1. Open the mobile app
  2. Tap Reports tab at bottom
  3. Tap + button
  4. Select New Session
  5. Optional: Give it a name like "Building A Walkthrough"
  6. Tap Start Recording

During the Session

Recording Indicator: - Tap Start Recording and tap again to stop - Red icon shows active recording - Timer displays duration - Keep each recording short, one task or problem per recording

During Recording:

Speak observations naturally: - "Water stain on ceiling near column B4, looks like roof leak, plumber needed" - "Electrical panel installed but not labeled yet, low priority" - "Question for architect: can we move this wall 2 meters north?"

Take photos: - Tap camera icon to take progress photos that don't need to go in the task list, only in the report - Tap the three dots next to the recording and there the camera icon, this links the photo to the resulting item - No limit on number of photos

Add text notes: - Tap text icon - Type quick notes - Useful for measurements or part numbers

Pause/Resume: - Tap pause to temporarily stop - Useful for private conversations - Tap resume to continue

Ending the Session

  1. Tap Generate report button
  2. AI begins processing immediately
  3. Each recording is reviewed

Reviewing Extracted Items

AI separates your recording into individual items: - Each observation becomes one item - Photos linked to relevant items - Type and priority auto-assigned - If the item already existed, it will be updated with the extra information or photos

For each item you can: - Accept as-is - Edit any field before saving - Reject if not needed

When done: Tap Save All to create all items

Session Report

After saving items, a session report is automatically generated.

For full details about report content, structure, and distribution, see the Reports Guide → and the Mobile App Guide →.

Draft Sessions

If you close the app before saving: - Session auto-saves as draft - Resume later from Reports tab - Drafts kept for 30 days

Best Practices

  • Speak clearly but naturally
  • Include location context ("near column B4")
  • Mention urgency when important
  • Take wide + close-up photos
  • Name sessions by location or date

Best for: Single quick observations on site

Time: 15 seconds

When to use: You spot one issue and need to capture it fast.

Quick steps:

  1. Tap Items → + button
  2. Fill in basic details
  3. Optionally add photo
  4. Save

Create a single item fast when you're on site.

Quick Capture Details

Opening Quick Create

  1. Open mobile app
  2. Tap Items at bottom navigation
  3. Tap + floating button (bottom-right corner)
  4. Panel slides up with form

Filling the Form

Select Type (required) - Tap button: Action, Decision, Issue, or Question

Enter Title (required) - Tap text field - Type brief description - Example: "Fix broken door handle room 204"

Optional Fields: - Description - Add more details - Priority - Low/Medium/High - Due Date - Tap calendar - Assignee - Select team member - Discipline - Type or select

Adding a Photo

Two ways:

Option 1: Before saving - Tap Add Photo in form - Take new photo or choose from gallery - Photo attaches to item

Option 2: After saving - Save item first - Open item detail - Tap Add Photo - Photo attaches

Pinning Location on Plan

If your project has floor plans: 1. Create/open the item 2. Tap View Plans tab 3. Navigate to correct floor/drawing 4. Tap location on plan 5. Item pins to that spot

No GPS Tagging

SiteWhiz doesn't use GPS coordinates. Instead, you manually pin items to specific locations on your uploaded floor plans for precise positioning.

Offline Capability

  • Create items offline (saved locally)
  • Upload when connection restored
  • Pending indicator shows unsynchronized items

Best for: Tasks that need information or checklists from your documents

Time: 30 seconds

When to use: A task that needs more information or you don't want to type.

Quick steps:

  1. Tap Question → Say or type "Create a task for..." for example "commissioning the heating system"
  2. The chatbot asks you follow-up questions
  3. Confirm that the task can be created
  4. Save

Tip: If you've added the manual for that gas chain to the project or procedure documents, the task will be created with a checklist or step plan based on the document in the cloud


After Creating an Item

Once created, items:

  1. Sync immediately - Visible on all devices (desktop + mobile)
  2. Appear in timeline - Tracked in project activity
  3. Become searchable - AI Assistant can answer questions about them
  4. Link to sources - Connect to documents, photos, sessions

Troubleshooting

For detailed troubleshooting for items, including session recording, AI extraction, photos and more, see the Troubleshooting Guide →.


Next Steps

Now that you can create items, explore: