Creating and Editing Templates

SwiftReporter provides comprehensive template editing capabilities that allow you to create custom templates, organize content, and integrate comments and notes for efficient inspections.

Template Creation Options

SwiftReporter offers multiple methods for creating templates to suit different workflows and needs:

Creating Blank Templates

Manual Template Creation:

1. Navigate to Templates: Go to the Templates section in your app
2. Create New Template: Select "Create New Blank Template"
3. Template Configuration: Build template structure manually:
   • Template name and description
   • Categories and subcategories
   • Questions and form fields
   • Template settings and options

Best For:

• Custom inspection types requiring unique structure
• Specialized inspection requirements
• Complete control over template organization

AI-Powered PDF Creation

Automated Structure Extraction:

1. Upload PDF: Use the "Create From PDF" option
2. AI Processing: The system analyzes your PDF to extract:
   • Categories and subcategories
   • Questions and form fields
   • Comment content
   • Template structure
3. Review and Refine: Edit the generated template as needed

Best For:

• Converting existing inspection forms
• Replicating established inspection workflows
• Quick template creation from proven documents

Learn More: See Creating Templates from PDF for detailed guidance.

Form PDF Templates

Blank Form PDF + Placement Workflow:

1. Open Template Editor: Open the template you want to configure
2. Upload Blank PDF: Use the Form PDF section to upload the official blank form
3. Place Fields: Use the placement tool to position typed answers, checkmarks, shapes, and signature-related placeholders on the PDF
4. Attach to Inspections: Add the finished form template from an inspection's Forms card

Best For:

• Official supplementary forms that must keep a fixed layout
• Signature, initials, and date placement on a known PDF
• Inspection workflows that need both the main report and one or more attached form PDFs

Learn More: See Using Form PDF Templates for step-by-step instructions.

Signature Fields: See Adding Signature Placeholders to Templates for a focused guide to signature, initials, and date placement.

Spectora Template Import

Seamless Migration:

1. Export from Spectora: Export template as Plain Text CSV/Excel
2. Import to SwiftReporter: Use "Import from Spectora" option
3. Automatic Conversion: System converts structure, questions, and comments
4. Customization: Refine imported template as needed

Best For:

• Transitioning from Spectora to SwiftReporter
• Preserving existing template investments
• Maintaining established inspection workflows

Learn More: See Importing Spectora Templates for step-by-step instructions.

Pre-built Template Library

Professional Ready-Made Templates:

1. Browse Library: Access professionally designed templates
2. Select Template: Choose template matching your inspection type
3. Copy and Customize: System creates personal copy for modification
4. Immediate Use: Start inspecting right away

Best For:

• Quick setup for standard inspection types
• Professional quality without development time
• Industry-standard inspection coverage

Learn More: See Using Pre-built Templates for comprehensive guidance.

Report Sections

Report Sections add an optional grouping above categories. They appear as a primary-bordered container in the editor wrapping the categories you assign to them. The feature is off by default; turn it on in the Template Settings panel under Report Sections. See Template Settings for the toggle.

When the feature is on, you manage sections directly in the main template editor (not in the settings panel).

Adding and Managing Sections (web)

1. Open the Template Editor: Open the template in edit mode.
2. Add a Section: Use the "Add section" action in the editor to create a new section.
3. Rename a Section: Click the section title bar to rename it inline.
4. Add Categories to a Section: Drag a category onto the section's container so it nests inside. Drag a category out of a section back to the root list to ungroup it.
5. Reorder Sections: Drag the section's title bar to reorder it relative to other sections and to ungrouped categories.
6. Delete a Section: Use the trash icon in the section title bar. Deleting a section removes only the wrapper — the categories inside and all their content are preserved at the root and are never deleted with the section.

Adding and Managing Sections (mobile)

1. Open the Template Editor: Open the template in edit mode.
2. Add a Section: Tap Add section.
3. Rename a Section: Tap the section title to rename inline.
4. Assign Categories to a Section: On each category, use the section picker to choose which section the category belongs to (or "no section" for the root list). Use the up/down move arrows on the picker to change the section's position in the list.
5. Move a Category Across Section Boundaries: The up/down move arrows keep stepping past the current section's edge and into the section above or below (or back out to the root list). You are not limited to reordering inside the current section.
6. Drop a Category Into an Empty Section: An empty section is a valid destination. The move arrows stop on an empty section instead of skipping past it, so you can place a category into a newly created section with no categories yet.
7. Section Header Options: The section title bar exposes an options control with Move section up, Move section down, and Remove section. Removing a section removes only the wrapper — its categories stay at the root.
8. Delete a Section: Tap delete on the section. The wrapper is removed, the categories stay.

Editing Sections During an Inspection

The same section editing experience is available when you edit the template attached to a specific inspection — not just when editing a library template. What you see in the library editor is what you get when adjusting a single inspection's structure.

Behavior with sections turned off: Templates that don't use Report Sections behave exactly as before — a flat list of categories with no section heading anywhere.

What you see while adding or deleting in the editor

Structural edits (adding or removing a report section, a category, or a subcategory) touch ordering and numbering, so the editor deliberately shows progress while the change is in flight — both on web and on mobile:

• Busy state on Add section, Add category, and Add subcategory. The control shows a pulse or shimmer (not just a disabled button) while the add runs, so you don't press it twice or wonder if the click registered.
• Busy state on delete. When you delete a section, category, or subcategory, the row stays visibly busy until it actually disappears, even if some cleanup work is still finishing.
• Auto-scroll to the new block. When you append a new section or category at the end of the list, the editor scrolls the new block into view just above the add controls, so you see the thing you just added without scrolling.
• Category cards stay fully rounded. A category card's body keeps rounded corners top and bottom, including the bottom edge, so it reads as one container at rest. A flat-bottomed card is a visual defect worth reporting.

Template Structure Management

Categories and Subcategories

Adding Categories:

1. Template Editor: Open your template in edit mode
2. Add Category: Use the "+" button to add new categories
3. Configure Category:
   • Set category title and description
   • Define order and priority
   • Configure category-specific settings

Managing Subcategories:

1. Within Categories: Navigate to the category you want to edit
2. Add Subcategories: Create specific component areas
3. Organization: Arrange subcategories logically
4. Content Assignment: Associate questions and notes with subcategories

Template Questions

Adding Questions:

1. Select Subcategory: Choose where to add the question
2. Question Type: Select from available types:
   • Text Input: Free-form text responses
   • Checkbox: Multiple choice selections
   • Dropdown: Single choice from options
3. Configure Question:
   • Write clear question text
   • Set default answers if appropriate
   • Mark as required if necessary
   • Turn on Allow photos if inspectors should attach photos directly to this question (see below)

Add-question modal: The "Add question" modal stays on screen and scrolls internally on shorter displays so every question type stays reachable.

"Other" free-text option (dropdown and checkbox questions):

• Add an option with a blank label to a dropdown or checkbox question.
• At inspection time, that option behaves as a free-text input the inspector can fill in.
• You do not need a separate "Other" question type.

Allow photos and videos on a question or required note:

• Toggle Allow photos on an individual question or required note to let inspectors attach photos to that item specifically.
• This is in addition to the existing subcategory-level photo plates.
• The toggle is available for every question type except signature placeholders.
• When set, captured photos appear in an inline grid directly under that question's answer in both the report editor and the generated PDF.
• Videos can also be attached to question and required-note grids (in addition to the existing observation-, subcategory-, and cover-grid support). Inline media accepts both photos and videos and is not used by form-PDF templates, which keep their existing photo behavior.

Question Management:

• Reorder Questions: Drag and drop to change order
• Edit Content: Modify question text and options
• Delete Questions: Remove unnecessary questions
• Copy Questions: Duplicate similar questions across subcategories

Required Notes Integration

Understanding Required Notes

Required notes are template-specific mandatory selections that ensure consistent information capture:

Three Types Available:

• Dropdown Notes (single-select): Inspector picks exactly one option from a list of preset notes.
• Checkbox Notes (multi-select): Inspector can pick any number of preset notes that apply.
• Text: Inspector must type a free-text note. The subcategory cannot be marked complete until at least one text note is written for this group.

"Add note" path: Each required-note group also has an optional Allow Add note toggle. When on, the inspector can satisfy the requirement by opening the searchable note picker (or creating a brand-new note on the spot) instead of choosing from the preset options. Use this when you want to mandate that some note is captured for the topic but the preset list isn't exhaustive.

Adding Required Notes

Step 1: Navigate to Subcategory

1. Template Editor: Open template in edit mode
2. Select Subcategory: Choose the subcategory for note placement
3. Find Required Notes Section: Locate the "Required Notes" area

Step 2: Create Note Group

1. Add Note Group: Click the "+" button next to "Required Notes"
2. Choose Type: Select single-select, multi-select, or text.
3. Set Title: Enter descriptive title for the note group
4. Allow Add Note (optional): Turn on Allow Add note if inspectors should also be able to satisfy the requirement by adding any note from the library or creating a new one (single-select and multi-select only).

Step 3: Configure Note Options

1. Add Notes: Select existing notes from your comment library. The note's title acts as the option label in the inspector's chooser, and the note's body content is hidden until the option is selected — keeps the picker scannable for long lists.
2. Create New Notes: Create notes specifically for this template. New notes also get a per-note Hide title toggle (see Creating Notes).
3. Organize Options: Arrange notes in logical order
4. Test Functionality: Verify note group works as expected. Multi-select keeps selections fluid — additional picks don't reset the chooser.

Required Notes Best Practices

Content Guidelines:

• Clear Titles: Use descriptive titles that explain the selection purpose
• Comprehensive Options: Include all reasonable choices
• Logical Grouping: Group related concepts together
• Regular Updates: Keep note options current with industry standards

Type Selection:

• Use Dropdown When: Only one condition can be true
• Use Checkbox When: Multiple conditions may apply simultaneously
• Consider Impact: Think about how selections will appear in reports

Comment Library Integration

Template-Comment Relationship

Comments in your library are organized by template association:

Filtering by Template:

• Comments are filtered by template for relevance
• Template selection affects available comments during inspections
• Proper organization improves search efficiency

Category Organization:

• Comments are further organized by category and subcategory
• Template structure determines comment organization
• Consistent categorization improves findability

Managing Template Comments

During Template Creation:

1. Plan Comment Structure: Design categories with comment organization in mind
2. Create Template-Specific Comments: Build comments tailored to template needs
3. Organize Systematically: Use consistent naming and categorization

Ongoing Maintenance:

1. Review Comment Relevance: Ensure comments align with template structure
2. Update Categories: Modify template structure based on comment usage
3. Clean Up Library: Remove or reassign comments as templates evolve

Advanced Template Features

Information Text

Subcategory Information:

• Add Context: Include helpful information for inspectors
• Rich Text Support: Use formatting for clarity
• Instructions: Provide guidance for complex procedures
• References: Include regulatory or standard references

Template Settings

Industry (top of Template Settings):

• Industry — Choose Home Inspection (default) or Marine Survey. This is the first setting in the Template Settings panel and controls which professional vocabulary the template uses, what the Inspection Details screen captures (Property Address vs. Vessel Identifier), and how the report PDF labels the inspection.

Observation Settings:

• Enable Severity: Add severity ratings (Low, Medium, High) to observations
• Enable Observation Summary: Auto-generate executive summary of all findings
• Summary Category: Designate which category contains the observation summary

Report Format Settings:

• Enable Cover Page: Include professional cover page with property and inspector details
• Enable Table of Contents: Add navigation section listing all categories and subcategories
• Report Layout: Control overall report structure and presentation

Advanced Configuration:

• Template Metadata: Name, description, version information
• Default Selections: Set default answers for common questions
• Validation Rules: Ensure data quality and completeness
• Integration Options: Link template to relevant comment categories

Detailed Configuration: See Template Settings for comprehensive settings guidance.

Template Testing and Validation

Testing Process

Before Deployment:

1. Create Test Inspection: Use template in practice inspection
2. Test All Features: Verify questions, notes, and comments work correctly
3. Check Report Generation: Ensure proper report formatting
4. Review User Experience: Assess efficiency and usability

Validation Checklist:

• All required notes function correctly
• Questions display and save properly
• Comment library filters work as expected
• Report generation includes all content
• Template structure is logical and efficient

Iterative Improvement

Feedback Integration:

1. Collect Usage Data: Monitor how template is used in practice
2. Identify Issues: Note common problems or inefficiencies
3. Make Improvements: Update template based on real-world usage
4. Version Control: Track changes and improvements over time

Collaboration and Sharing

Template Management

Team Templates:

• Shared Templates: Create templates for team use
• Version Control: Manage template updates and changes
• Access Management: Control who can edit templates
• Standardization: Ensure consistency across team members

Template Distribution:

• Export/Import: Share templates between users or systems
• Template Libraries: Build collections of specialized templates
• Best Practice Sharing: Share successful template designs
• Training Materials: Create documentation for template usage

Troubleshooting Template Issues

Common Problems

Required Notes Not Working:

• Check Note Assignment: Verify notes are properly assigned to groups
• Validate Note Content: Ensure notes exist in comment library
• Test Selection Types: Confirm dropdown/checkbox functionality
• Review Template Structure: Check subcategory organization

Comment Library Issues:

• Category Mismatch: Ensure comments are properly categorized
• Template Association: Verify comments are linked to correct template
• Search Problems: Check comment titles and descriptions
• Access Issues: Confirm template permissions and associations

Performance Optimization

Template Efficiency:

• Streamline Structure: Remove unnecessary categories or questions
• Optimize Required Notes: Include only essential mandatory selections
• Improve Organization: Arrange content for logical workflow
• Regular Maintenance: Keep templates current and efficient

Best Practices Summary

Template Design

• User-Centered: Design templates for efficient inspector workflow
• Logical Organization: Structure categories and subcategories clearly
• Comprehensive Coverage: Include all necessary inspection areas
• Flexible Framework: Allow for unique situations while maintaining consistency

Content Integration

• Strategic Comments: Build comment library aligned with template structure
• Essential Notes: Include only truly necessary required notes
• Clear Questions: Write unambiguous, actionable questions
• Professional Presentation: Ensure templates produce professional reports

Maintenance and Evolution

• Regular Review: Periodically assess and update templates
• Usage Analytics: Monitor template performance and efficiency
• Continuous Improvement: Refine templates based on real-world use
• Documentation: Maintain clear documentation for template usage

Effective template editing creates the foundation for efficient inspections and professional reports. By thoughtfully integrating comments, notes, and questions, you can create templates that streamline your workflow while ensuring comprehensive coverage of all inspection requirements.