Managing Job States

Each Job holds a State, such as "In Progress", "Planned", or "On Hold".

FYI includes a function so that an FYI Admin can map Job States to how the States display and are used in FYI. This allows you to select the colour coding of how they show in FYI.

For practices integrated with Xero Practice ManagerJob States must be allocated to a current Job in Xero Practice Manager to enable the Job State to sync to FYI. Refer to the section below Adding a New Job State in Xero Practice Manager.

For information on syncing Job States, renaming and deleting a Job State in Xero Practice Manager, refer to Job States.

Displaying and Managing Job States in FYI

To display and manage the Job States in FYI.

  1. Log in to FYI as an FYI Admin.
  2. From FYI, click Settings in the top right-hand corner.
  3. Select Practice settings from the drop-down, then select Jobs.
  4. Go to the States tab.

A list displays the Job States your practice has defined.

The Practice settings - Jobs - States list displays as follows.


Showing Archived Job States

To show the Archived Job States in the list, click Unhide the archived states.


To hide the "Archived" Job States in this list, click the Hide the archived states button at the top.


Updating Job States

Type - For each State, the Type determines what should be defined as an 'open' job or an 'inactive' job in FYI. This is used when displaying jobs in lists to hide inactive jobs.

  • Standard - Any of the States used by your practice that is considered to be open, for example, states such as In Progress, Planned, and  Running.

  • Completed, Cancelled, On Hold, or Archived - Any of the States used by your practice that is considered to be "inactive", for example, for states such as Lost, and  Cancelled.
    'Inactive' Jobs are not shown in selections and are hidden in the Jobs workspace by default.

In the Jobs list, you can show inactive jobs by clicking Unhide the inactive jobs. This shows jobs that have a Status set in FYI with the Type set as "Completed", "Cancelled", "On Hold" or "Archived" 

To hide inactive jobs, click  Hide the inactive jobs.


If a Job state is removed in Xero Practice Manager, you can set the FYI Type to "Archived" so it is not included in any filters.

Hide from Board - For any Jobs States that you do not want to see in the Jobs Board, set this to "Yes". Refer to Using the Jobs Board.

Colour - You can set the colour in which the State displays in Job lists. You can use a system such as "Green", "Amber" or "Red", or use any of the other colours such as "Blue", "Grey", "Silver", "Teal", and  "Black".

Note: FYI can only sync job data, including Job States, for "current" jobs, that is for jobs in Xero Practice Manager where the State Type is "Standard". This includes syncing of Workflow Jobs for practices that have this feature enabled.
Therefore, when jobs are initially synced to FYI, a State will only be imported if it is allocated to any current jobs. If there are no current jobs for a particular State, that State will not be initially imported to FYI.

Making Changes to the Job States

Changes to the Job States are made using the drawer. Click on a Job State in the list. You can then change the settings, including the colour of how they show in FYI.


If your practice is integrated with Xero Practice Manager, name changes must be made in Xero Practice Manager. If you rename a Job State in XPM, this will sync to FYI and create a new Job State name. 

Note: This excludes case-sensitive changes. Changing a Job State from 'In progress' to 'In Progress' will update the existing Job State.

Changing the Sequence in which Job States show in FYI

The order in which the Job States show in Settings determines the sequence in which they display in the State drop-down (when changing the State) and also the order in which they display from left to right in the Jobs Board (refer to Using the Jobs Board).

To change the sequence in which the Job States display, click the up arrow or down arrow at the top of the drawer.


The Order column displays the numerical sequence in which the Job States are displayed.

Hiding Job States from the Job Board

The Jobs List can be changed to a Board view, a Kanban style of board with a column for each Job State.

1147 Jobs Board.gif

If the Job State has the Hide from board option enabled, a column will not be created for that Job State on the Job Board.

Refer to Using the Jobs Board.

Archiving a Job State in FYI

To archive a Job State in FYI, select the Type "Archived" in the drawer. Once a Job State has been archived, it will:

  • Continue to appear in the jobs list if there are Jobs that still have that state selected (these should be updated if required).
  • Be hidden from filters so that users are not able to select the state when filtering the Jobs List.
  • Not be displayed in the drop-down State list when updating a job.

Note: If you set a Job to an "Archived" State, you can currently only change the State using Jobs Bulk Update (refer to Jobs Bulk Update). Yyou cannot change the State from the Job drawer or the Job - Summary tab. Alternatively, you can change the Type of the State to something other than "Archived" which will then allow you to change the State of the Job in the drawer or Job - Summary.

Adding a New Job State in Xero Practice Manager

When adding a new Job State in Xero Practice Manager:

  • You can nominate which of the Xero Practice Manager States is used to indicate an "inactive" job.
  • The new state must be allocated to a current Job in Xero Practice Manager before it will sync to FYI.
  • When a new Job State is synced from Xero Practice Manager to FYI, it will be automatically assigned a colour in FYI. This is selected randomly from the current list of available colours.

Note: Perform a manual Job Sync to add Job States to FYI quickly. Refer to Running a Manual Sync with Xero Practice Manager and Additional Notes on Syncing.

Adding a New Job State in FYI - Beta

Adding Job States in FYI is a Beta release. This would be used if you connect to a practice management system other than Xero Practice Manager or Xero Tax.

If you are part of the Beta release for this, you can add Job States in FYI. These are only available in FYI and are not synced to your practice management software.

  1. In the Jobs States list, click the Add button in the top right-hand corner.

  2. In the same way as when updating a Jobs State (see above), enter the Name, select the Type and Colour, and, if relevant, select Hide from Board.


  3. Click Create.

If required, you can then change the sequence in which the new Job State displays.

Was this article helpful?
4 out of 4 found this helpful