Troubleshoot documents

Verified against commit 6c69a4b5 min read

The Documents area stores standard operating procedures (SOPs), certificates, licences, policies, and other reference files. Use this guide when a document will not open, an SOP cannot be changed, or the information shown is missing or out of date.

Common problems

Start in SOP and Other Files and check the relevant library:

If the page or file does not respond, refresh the page and try again. If the problem affects only one file, try another file in the same document type. This helps identify whether the issue is with the file itself or with access to Documents.

Documents that cannot be opened

If a document type does not open:

  1. Return to SOP and Other Files.
  2. Search for the document type by name or heading.
  3. Select the row again.
  4. If the document type is listed but still will not open, refresh the page and try again.

If a file does not open from the document page:

A document type that has been removed is no longer available to open. Deleting a document type also permanently deletes all of its uploaded documents, so it cannot be recovered in the app.

SOPs that cannot be edited

The Edit button is available only to users with permission to change Documents. Staff and foremen have view access by default, so they can read documents but cannot edit document types, add files, replace files, change descriptions, or delete files. Managers have full access by default. An administrator can change these permissions for your organisation.

If you can view an SOP but cannot edit it:

When editing an SOP, you can update its document type, library, and heading. You can also change an attached file’s name or description, replace the file, remove an attachment, or use Add New to attach another file. Select Save changes when finished. The file itself is not uploaded until you save the changes.

Missing or outdated document information

The document list shows these fields:

Inside a document type, each attachment shows its Description, File, Uploaded, and By information. A dash means that no value has been provided for that field.

If information is missing or outdated:

  1. Open the document type from SOP and Other Files.
  2. Select Edit, if you have permission.
  3. Update the document type or heading as needed.
  4. For an attachment, update its file name or description, or select Replace to provide a newer version.
  5. Select Save changes, then refresh the document page.

To add a file to an existing document type, select Upload File, then Add files. The app accepts any file type, but each file must be smaller than 250 MB. You must add at least one file before selecting Upload. Enter a description while the file is queued if other staff need help identifying it.

If Files shows zero, there are no attachments for that document type. A user with edit access can select Upload File to add one. When creating a new document type, attachments are added after the entry is created.

When to contact an administrator

Contact an administrator when:

Include the document type name, attachment file name, what you were trying to do, and any message shown on screen. This gives the administrator enough information to check your access and resolve the problem quickly.