Feature Explained - Tell Your Story - Web App

In this article


Tell Your Story is the PeopleSafe way of reporting and recording accidents, incidents, hazards/risks, near misses, injuries, pain or discomfort, and nice jobs. Tell Your Story uses everyday language so everyone with a login to PeopleSafe can confidently tell their stories about what's really happening at work.

The Tell Your Story feature is the name of the online process in PeopleSafe, that helps you build a complete story about what happened without having to answer irrelevant questions. The intelligent form uses a combination of questions to answer, clickable boxes, drop-down selectors, and sliders to gather all the information about your story. Tell Your Story can even determine by the fields filled in whether a story is potentially serious or not and will send out the relevant alerts and notifications to users who need to know.

Everyone, who has access to PeopleSafe and is connected to an organisation that uses PeopleSafe, can tell their safety story using the Tell Your Story feature. 

How Tell Your Story Helps

Having a central record of all the accidents, risks, and basically any story that happens as part of the work you do is important. Not only does it help you work out and fix the things that are going wrong, it also makes sure you don't break the law.

The Tell Your Story process is:

  • quick to complete
  • your staff can access it anytime
  • it's in plain English without the health and safety jargon
  • super user friendly

When a User puts a safety story in PeopleSafe using the Tell Your Story feature, PeopleSafe will send out email and txt alerts to the appropriate people to notify them that a story has been told. The notification will include the basic details of the story and a link to click through to the full story details.
Now no one can say they weren't aware of an incident happening as everyone gets notified straight away at the same time.

The Tell Your Story process is only the first piece of the puzzle. Once the story has been told there are a couple things that need to happen. The first is called a Story Review. Reviewing a story is where the story details are investigated and we learn what real life changes need to be made. The second are Story Tasks. This is where the real life changes are made and recorded in PeopleSafe as tasks. Tasks are the proof that we're being proactive and trying to improve health and safety at work.


" It’s unrealistic to expect your work will always be 100% healthy and safe. Injuries, illnesses, incidents and near misses can — and do — happen. It’s important that when they do happen, you and your workers take the time to review and learn from them. 

Depending on the nature, severity and complexity of the incident, learning from an H&S incident might be as simple as chatting to staff afterwards so you can all try to figure out what went wrong — and what can be done about it."  

For further information: https://www.business.govt.nz/risks-and-operations/health-and-safety/plans-tools-and-learning-from-incidents/

How Tell Your Story Works

  • For users with Coordinator and Manage Users security clearance, Tell Your Story is accessed by clicking on the Tell Your Story button in the Stories tab.
  • For users with Standard Staff security clearance Tell Your Story is accessed by clicking on the Stories tab.
  • Users must begin their story by selecting a Story Type to determine the questions they will answer. 
  • All stories except 'Nice Job' stories can have multiple story types selected.
  • Questions and fields with a red asterix are compulsory and must be filled in before the user can continue to the next page. 
  • For extra help users can click on the grey Question Marks for a pop-up to appear with further explanation about the field. 
  • 'Where did it happen', 'Activity Happening at the Time' and 'Type of Gear Involved' are customisable fields. 
  • Tell Your Story has triggers to determine whether a story is potentially serious or not. Read about the triggers HERE
  • Stories told can be edited at the review stage.
  • Attachments and notes can be added to the story record only after the story has been through the review process.
  • A story is assigned an ID number only after the story has been through the review process.
  • A story can be deactivated only after the story has been through the review process.

Getting Started

As soon as users have been given their usernames and passwords to log into PeopleSafe, they have all they need to start telling safety stories immediately. We recommend that all types of stories be encouraged and welcomed.

Expected Step by Step Process

  • (Optional) Coordinator creates site specific places and activities for Tell Your Story fields.
  • Users are given their unique Usernames and Passwords 
  • Users tell safety stories about the work they do
  • Managers and Coordinators are notified of stories told
  • Managers and Coordinators verify the story with the story teller or other workers and give immediate aid as required
  • The appropriate person reviews the story told in PeopleSafe
  • Followup tasks (sometimes called corrective actions) are created in PeopleSafe
  • Notes and attachments that support the investigation are added to the story record in PeopleSafe
  • Followup tasks are actioned and completed in PeopleSafe

Adding, Reviewing, Editing or Deactivating Stories

Click on the Help Articles below for more detail.

How to  Tell A Story
How to  Review A Story
How to  Add Attachments to a Story
How to  Create Story Reports

How to  Deactivate a Story

Access Permissions

Users with Coordinator Security Clearance can:

  • Tell Stories.
  • View the full list of Stories told.
  • Review Stories.
  • Upload and delete Story attachments.
  • View the history of Stories.
  • View and edit all Story notes.
  • Deactivate Stories.
  • Export Story data via CSV.
  • Create Story Reports

Users with Manage Users Security Clearance can:

  • Tell Stories.
  • Review Stories told from users they have been given visibility of.
  • View and Edit Stories told from users they have been given visibility of. 
  • View notes in Stories told if a) they have visibility of the user and b) they are the creator of the note.
  • Create Story reports that include data from users they have been given visibility of.

Users with Standard Staff Security Clearance can: 

  • Tell Stories.



Stories are only half the equation. It's great to have stories told but just as important as having the paperless record is reviewing the story.
The story review process is your opportunity to investigate the story. A review allows you to explore the root causes of the incident, add more information to the story and create action follow up tasks (sometimes called corrective actions). Completing a story review and using tasks to track actions taken is essentially creating the proof that your organisation is being proactive in incident prevention and following the law.


Rare occurrences determine that a story might need to be deactivated. A story may be deactivated at any time but only once the story has had a story review. 
Deactivating a story will delete the story details, notes, and attachments. Deactivating a story will NOT delete any tasks associated with the story.

In the context of stories, deactivating a story effectively is the same thing as deleting a story. Deactivated stories cannot be retrieved and returned to the stories list.

Related Processes and Tasks

All Coordinators, and Managers who are assigned as the Manager of staff involved in a story, will receive an email story alert which contains the main details of the Story, and will be assigned the review task. When a Story is deemed 'serious' by way of certain triggers PeopleSafe will send out an extra notification by way of TXT alert and email to users with Coordinator Security Clearance, and anyone with a Manage Users Security Clearance, providing that their profile has these settings set correctly to On. These extra alerts are designed to help management take appropriate actions sooner and assist in incident notification across the organisation.


Smart-lists allow the following story fields to be filtered in preparation for print, PDF, CSV, or bar graph reports:

  • Story Type selected
  • Story 'What Happened' details
  • Injured or Involved persons
  • Where the story occurred
  • Who Reported the story
  • Activity
  • Severity
  • Whether the story is 'Rated as Serious'
  • The story importance
  • Organisation the story was told in (useful for users with All Organisation view)

In One-click Story Reporting, the Story does not attempt to record which of a staff member’s Jobs they were performing at the time, so a single story may appear related to multiple Jobs.

Known Limitations

One-click Story reports may show different numbers if collating numbers across different reporting categories. This is because a single story can contain more than one reporting category, i.e. a story can contain an injury, damage and and be an accident all at once. 

Export Data

Stories and directly associated data can be exported in .CSV format at any time. How to: Export Data from PeopleSafe

Further Help

External Resources:

Approved Code of Practice: Roles and Responsibilities for principals and contractors

Business GOVT - Compliance Matters: Keeping Your Business Safe 

Accident Compensation Corporation: Training, Supervision and Hazard Management. 

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still Stuck? Email the Help Team Email the Help Team