Set Up Universal Print Printers
Note
Note:
Azure Active Directory is now Microsoft Entra ID. Learn more.
Universal Print is a Microsoft 365 subscription-based service that runs entirely on Microsoft Azure. It gives you centralized printer management through the Universal Print portal. Business Central makes printers set up in Universal Print available to client users through the Universal Print Integration extension.
The complete setup requires you work in both Microsoft Azure, using the Azure portal, and in Business Central. The setup is divided between two main tasks as described in this article:
- In Microsoft Azure, set up Universal Print and add the printers you want to use in Business Central to a print share. Go to this section.
- In Business Central, add the printers from the print shares in Universal Print. Go to this section for online or here for on-premises.
Prerequisites
Supported printers
Business Central supports the same printers as Universal Print, which can be either Universal Print–compatible or non-compatible printers. Non-compatible printers can't communicate with Universal Print directly, so they require extra connector software, which is provided by Universal Print. Some older printers may not be supported.
Universal Print:
A Universal Print subscription/license for your organization.
Learn more at License Universal Print.
You have at least the Printer Administrator role in Microsoft Entra ID.
To manage Universal Print, your account must have at least the Printer Administrator role in Microsoft Entra ID. These roles are only needed for managing Universal Print. They aren't required by people setting up and the printers from Business Central.
Business Central online and on-premises:
Business Central 2021 release wave 1 or later.
Universal Print Integration extension is installed.
This extension is published and installed by default as part of Business Central online and on-premises. You can verify whether it's installed on the Extension Management page. Learn more at Installing and Uninstalling Extensions in Business Central.
Business Central on-premises only:
Microsoft Entra ID or NavUserPassword authentication is configured.
Note
Universal Print extension doesn't support service-to-service (S2S) authentication. It requires a signed-in user to send print jobs to the Universal Print service through Graph API.
An application for Business Central is registered in your Microsoft Entra tenant and Business Central.
Like other Azure services that work with Business Central, Universal Print requires an app registration for Business Central in Microsoft Entra ID. The app registration provides authentication and authorization services between Business Central and Universal Print.
Your deployment may already use an app registration for other Azure services, like Power BI. If so, then use the existing app registration for Universal Print as well, instead of adding a new one. The only thing you'll need to do, in this case, is modify the app registration to include the relevant print permissions for Microsoft Graph API: PrinterShare.ReadBasic.All, PrintJob.Create, and PrintJob.ReadBasic.
To register an app and set the proper permissions, follow the steps described in Register an application in Microsoft Entra ID.
Set up Universal Print and printers in Microsoft Azure
Before you can start managing Universal Print printers in Business Central, there are several tasks to get Universal Print up and running in Azure with the printers you want to use.
For detailed instructions on how to get set up, see Get started: Set up Universal Print in the Universal Print documentation. Here's an overview of the steps you'll need to complete. Most of these steps are done in the Azure portal.
Assign Universal Print licenses to yourself and other users.
How you assign the license depends on whether you're integrating with Business Central online or on-premises.
With Business Central online, you assign licenses using the Microsoft 365 admin center.
Learn more at Microsoft Admin Center Help - Assign licenses to users.
With Business Central on-premises, you assign licenses in your tenant using the Azure portal.
Learn more at Assign or remove licenses in the Azure portal.
Install the Universal Print connector for registering printers that can't communicate with Universal Print directly.
Most in-market printers can't communicate with Universal Print directly, so you'll need to install the Universal Print connector. Learn more at Installing the Universal Print Connector.
Register your printers in Universal Print.
Registering a printer makes Universal Printer aware of the printer.
For printers that can communicate directly with Universal Print, follow the steps provided by the printer manufacturer.
For other printers, register the printers by using the Universal Print connector.
Learn more at Printer registration.
Change printer properties (optional)
After a printer is registered, you can view and modify printer properties, such as default preferences.
Learn more at Managing Printer Settings using the Universal Print Portal.
Share the printers with users.
Any printer you want to use in Business Central will need to be added to a printer share in Universal Print. Any user who needs access to the printer must be added as a member of the printer share. Learn more at Share a Printer.
Tip
You can always add or remover users later. Learn more at Configure user permissions for printer share.
Enable document conversion.
Universal Print renders content for print in XPS format. Some legacy in-market printers don't support XPS content rendering&mdashin many cases, only PDF format. Printing to these printers will fail unless Universal Print is set up to convert documents to the printer-supported format.
Learn more at Document conversion.
Now, you're ready to add the printers to Business Central, set up default printers for reports, and print.
Add printers in Business Central online
After printers are set up and shared in Universal Print, you're ready to add them to Business Central for use. There are two ways to add Universal Print printers. You can add the printers all at once or individually, one at a time.
Adding printers individually let's you set up the same Universal Print printer in Business Central more than once. Then, for each added printer, you can change the print settings, like paper tray, size, and orientation. This way, you can set up printers for different reports and documents with special output requirements.
Note
Note:
Are you using Business Central on-premises? If so, go to the next section, the first time setup is slightly different.
Choose the
icon, enter Printer Management, then select the related link.Select Universal Print, then choose one of the following options:
- Add all Universal Print printers to add all printers not already added. You can use this option even if there are already printers added.
- Add a Universal Print printer to add a specific printer.
Follow the on-screen instructions.
If you chose Add all Universal Print printers, then the Add Universal Print Printers setup starts.
If you chose to Add a Universal Print printer, then the Universal Printer Settings page appears. Fill in the Name field, then select ... next to the Print Share in Universal Print field to select the printer share that contains the Universal Print printer. Fill in the remaining fields as needed. Hover over a field to read a short description..
After a printer has been added, you can view and change its settings from the Printer Management page. Just select the printer, then choose Edit printer settings.
Add printers in Business Central on-premises
Before a user can add or use Universal Print printers Business Central, they have to authorize access to the Azure services used by Universal Print and grant it to permission to data and operations like:
- Signing in and reading user profile
- Reading basic print job information
- Creating print jobs
This is typically done the first time they connect to the Azure registered app used for Universal Print. In Business Central online does, this authorization flow is done seamlessly, with no user interaction. But Business Central on-premises operates differently. It requires that you, or any other user who wants to use Universal Print printers, initiate the authentication flow—usually, one time only. The most direct way is described in the following steps. A less direct way is by connecting to another integrated service that uses the same Azure registered app, like Power BI or OneDrive. Each user typically only has to do this task once.
Note
Note:
If you're an admin, we recommend you complete this task before other users. Then afterwards, inform users who will need to use Universal Print printers how to do it. If the Azure registered app for Universal Print requires admin consent for API permissions, it's easier if you grant consent on behalf of the organization. You can grant admin consent from the Azure Portal or when you run the steps that follow.
Connect to Universal Print for the first-time
Complete these steps to connect to the Universal Print service for the first-time.
Choose the
icon, enter Printer Management, then select the related link.Select Universal Print > Add all Universal Print printers to start the Add Universal Print Printers assisted setup guide (wizard).
Follow the on-screen instructions until you get to the MICROSOFT ENTRA SERVICE PERMISSIONS page.
Select the Authorize Azure Services link.
If the Permission Requested page appears, read it carefully and select Accept to agree and continue. If you're running as an admin, you can select Consent on behalf of organization if you want to consent for all users.
.If you're prompted, sign in using your name and password.
When authorization completes successfully, you're returned to the Add Universal Print Printers page. Select Next > Finish to complete the setup.
After a printer has been added, you can view and change its settings from the Printer Management page. Just select the printer, then choose Edit printer settings.
Once you complete the initial sign-in, you can use the Universal Print printers to print reports and other print jobs. For more information, go to Printing a Report. If you want to add, remove, or change any printers, just go back to the Print Management page and select Universal Print.
Common problems and resolutions
In this section, you'll learn about the common problems that users may experience when trying to set up or use Universal Print printers.
You don't have access to the printer <your-printer>.
If a user gets this message when trying to print a document to a Universal Print printer, it may be caused by one of the following conditions:
- The user doesn't have Universal Print licensed assigned to their Microsoft 365 or Azure Active AD account.
- The user isn't assigned to the printer share in Universal Print.
- (On-premises) The Azure app registration used for Universal Print isn't working or has recently changed since the last time the user signed in.
- (On-premises) The user hasn't yet signed in to Azure registered app for Universal Printer app and consented for the first time.
There was an error fetching printers shared to you.
If a user gets this message when trying to add a Universal Print printer from the Printer Management page, it's typically because they haven't yet signed in to Azure registered app for Universal Printer app and consented for the first time.
Next steps
See also
Printers Overview
Set Up Email Printers
Printing a Report
Work with Business Central
Run Batch Jobs