> ## Documentation Index
> Fetch the complete documentation index at: https://withforerunner.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Completing workflow steps

> Submit information for each step in your workflow

Each workflow step requires you to submit specific information. Completing steps moves your application forward and keeps everything connected to your workflow history.

## Understanding workflow steps

A workflow step is a specific form or record type that's part of your overall application. For example, a building permit workflow might include:

* Step 1: Initial application
* Step 2: Site plan submission
* Step 3: Supporting documents
* Step 4: Final review

Each step corresponds to a type of record. When you complete a step, you're creating a record that becomes part of your workflow.

## Completing a step

When you're ready to work on a step:

<Steps>
  <Step title="Open your workflow">
    Navigate to your workflow from the Workflows section or from the associated property page.
  </Step>

  <Step title="Find the active step">
    Look for steps with action buttons like:

    * **Create** - Start this step (for steps you haven't begun)
    * **Continue** - Resume work on a step you've started
    * **View** - See a completed step (read-only)
  </Step>

  <Step title="Click the action button">
    Click **Create** or **Continue** to open the form for that step.
  </Step>

  <Step title="Complete the form">
    Fill in all required fields. Required fields are marked and must be completed before you can submit.

    * Enter text, numbers, dates, and other information as requested
    * Upload any required files or documents
    * Review conditional fields that may appear based on your responses
  </Step>

  <Step title="Submit the step">
    When you've completed all required fields, click **Submit** or **Save** to record your submission.
  </Step>
</Steps>

<Check>
  **Success!** Your step is recorded and the workflow updates to show your progress. The next step (if any) becomes available.
</Check>

## Step order and dependencies

Workflows typically have steps that must be completed in order:

**Sequential steps** - You must complete step 1 before step 2 becomes available. The workflow enforces this order.

**Visible but locked** - You may see future steps but cannot start them until prerequisites are complete.

**Current step indicator** - The step you should work on next is highlighted or has an active action button.

<Tip>
  Focus on the step with the "Create" button. That's the next step in your workflow that needs your attention.
</Tip>

## Working with forms

Each step presents a form specific to that part of the workflow. Forms can include:

### Field types

| Field type      | Description                              |
| --------------- | ---------------------------------------- |
| **Text**        | Short or long text entries               |
| **Number**      | Numeric values, sometimes with units     |
| **Date**        | Date picker for selecting dates          |
| **Dropdown**    | Select from predefined options           |
| **Checkbox**    | Yes/no or multiple selection options     |
| **File upload** | Attach documents, images, or other files |
| **Location**    | Map-based location selection             |

### Conditional fields

Some fields only appear based on your answers to other questions. For example:

* Selecting "Yes" to a question may reveal additional detail fields
* Choosing a specific option from a dropdown may show related questions
* Certain responses may skip sections that don't apply

<Note>
  Conditional logic is configured by your community. If you're unsure why certain fields appear or don't appear, review your previous answers or contact your community for guidance.
</Note>

### Required fields

Required fields are marked and must be completed. You cannot submit the step until all required fields are filled in.

If you try to submit with missing required fields:

* You'll see an error message
* Missing fields are highlighted
* The form scrolls to the first incomplete field

## Uploading files

Many workflow steps require document uploads:

<Steps>
  <Step title="Find the file upload field">
    Look for fields that accept file attachments. They typically show an upload button or drop zone.
  </Step>

  <Step title="Select your file">
    Click to browse your files, or drag and drop a file into the upload area.
  </Step>

  <Step title="Wait for upload">
    Larger files may take a moment to upload. Wait for the upload to complete before submitting the step.
  </Step>

  <Step title="Verify the upload">
    Confirm your file appears in the field before submitting. You may see a thumbnail or filename.
  </Step>
</Steps>

<Warning>
  Supported file formats and size limits depend on the specific field. Common formats include PDF, JPEG, PNG, and TIFF. If your file is rejected, check that it meets the requirements shown in the field instructions.
</Warning>

## Saving your work

Your progress is typically saved as you work:

**Auto-save** - Most forms save your entries automatically as you complete fields.

**Draft state** - If you leave without submitting, your work may be saved as a draft.

**Manual save** - Some forms have a "Save draft" option to explicitly save without submitting.

<Tip>
  Even if auto-save is enabled, it's good practice to complete steps in one session when possible. If you need to leave, look for a "Save draft" option.
</Tip>

## What happens after you submit

When you submit a step:

1. **Record created** - A record is created and linked to your workflow
2. **Step status updates** - The step changes from "In progress" to "Succeeded" (or awaits review)
3. **Progress updates** - Your overall workflow progress bar advances
4. **Next step available** - If there are more steps, the next one becomes accessible
5. **Notification sent** - You may receive an email confirming your submission

### Steps requiring review

Some steps require review by your community before they're marked complete:

* Your submission is recorded and held for review
* The step may show "In progress" or "Pending review"
* You receive notification when the review is complete
* The step status changes to "Succeeded" or "Failed" based on the review

If a step fails review, you'll typically receive information about what needs to be corrected.

## Viewing completed steps

After completing a step, you can return to view your submission:

<Steps>
  <Step title="Open your workflow">
    Navigate to the workflow from your workflow list.
  </Step>

  <Step title="Find the completed step">
    Completed steps show a "View" button instead of "Create."
  </Step>

  <Step title="Click View">
    Opens the step in read-only mode, showing all the information you submitted.
  </Step>
</Steps>

This is helpful for:

* Reviewing what you submitted
* Referencing information for later steps
* Confirming uploaded documents
* Downloading copies of records

## Step permissions

Your ability to interact with steps depends on your permissions:

**Create** - You can create new submissions for this step.

**Update** - You can edit existing submissions (if the step allows editing after submission).

**View** - You can see the step and any submissions, but cannot create or edit.

Some steps may only be visible to certain user groups. If you don't see a step you expect, it may be assigned to a different group or role in your community.

## Troubleshooting

<AccordionGroup>
  <Accordion title="I can't find the action button to start a step">
    **Solution**: Check if you need to complete earlier steps first. Workflows often require sequential completion. Also verify you have the appropriate permissions—some steps may only be accessible to certain user groups.
  </Accordion>

  <Accordion title="The form won't submit">
    **Solution**: Check for required fields that haven't been completed. Required fields are marked and must be filled in. Also check for errors—some fields have specific format requirements. File uploads must complete before you can submit.
  </Accordion>

  <Accordion title="I need to change something I already submitted">
    **Solution**: Once submitted, steps may be locked for editing. If you need to make changes, contact your community. They can advise whether amendments are possible and what the process is.
  </Accordion>

  <Accordion title="My file upload failed">
    **Solution**: Check the file size and format. There may be limits on file size (typically 50MB) and accepted formats (PDF, JPEG, PNG, TIFF, GIF are common). Try compressing larger files or converting to an accepted format.
  </Accordion>

  <Accordion title="I accidentally submitted incomplete information">
    **Solution**: Contact your community as soon as possible. Explain what information was incomplete or incorrect. They can advise on next steps, which may include adding a new submission or correcting the existing one.
  </Accordion>

  <Accordion title="A step I need is marked 'Skipped'">
    **Solution**: Steps are typically only skipped by community staff during their review process. If you believe a step should be available to you, contact your community for clarification.
  </Accordion>
</AccordionGroup>