Available in PaperCut NG and PaperCut MF.

Retrieve toner levels (for supported printers)


Managing printer toner on a large fleet of printers can be a time-consuming task. The administrator must track toner usage and ensure that replacement toner cartridges are available when printer toner runs out. Often the administrator is only made aware that a printer is out of toner after receiving complaints from users. PaperCut NG/MF can track the toner levels for supported printers and provide toner level information in reports or email notifications when the toner is low.

Armed with this information the administrator can purchase toner supplies in advance and replace toner cartridges before the printer runs out of toner. This saves time and ensures that printer downtime is minimized.

You might also want to take a look at Low printer toner notifications.

How toner level information is retrieved

PaperCut NG/MF retrieves toner information from supported printers using the SNMPSimple Network Management Protocol (SNMP) is a component of the Internet Protocol Suite as defined by the Internet Engineering Task Force (IETF). It consists of a set of standards for network management, including an application layer protocol, a database schema, and a set of data objects. Devices that typically support SNMP include routers, switches, servers, workstations, printers, modem racks and more. network protocol. Most modern network printers allow the toner information to be queried via SNMP.

PaperCut NG/MF can retrieve toner information for printers that meet the following requirements:

  • The printer supports the SNMP standard for printers (RFC 1759) that allows toner information to be retrieved in a standardized way. Most network printers support this standard. There is also support for the private MIBs of Brother and Ricoh.

  • SNMPv1/v2c or SNMPv3 is enabled and configured.

  • The printer is networked (that is, it is connected to your network and not directly to a computer with a USB or parallel port).

  • Your network (for example, routers, firewalls, etc.) allows the PaperCut NG/MF server to establish SNMP connections between the PaperCut NG/MF server and your printers.


    When the PaperCut NG/MF server is unable to establish SNMP connections, the number of retry attempts made to re-establish connections and the duration of the timeout between each retry attempt, are configurable. Configure these values using the following advanced configuration variables:

    printer.snmp.retries – Determines how many retry attempts will be made by the PaperCut NG/MF server to re-establish SNMP connections. By default, 4 retry attempts are made.

    printer.snmp.timeout-millis – Determines the duration of the timeout (in milliseconds) between each retry attempt. By default, the timeout is 5 milliseconds.

Generate a report of toner levels

PaperCut NG/MF regularly updates the toner information to ensure the data is kept up to date.

You can generate a report with 'Toner Status', 'Lowest Toner Value' and 'Toner Last Updated on' fields from the Admin web interface.

  1. Click the Printers tab.

    The Printer List page is displayed.

  2. At the bottom of the list select Export / Print in Excel format.


The thresholds for low and very low toner level warnings visible on Dashboard are configurable. Configure the threshold values using the following config keys - toner.low-threshold and toner.very-low-threshold . See Using the Advanced Config Editor to find out how to change config keys.