Preview 1 Release Notes and FAQS

New and improved features

BarTender 2020 Preview 1 introduces significant performance improvements, a redesigned Print Portal web printing solution, and many new and improved features to help you create your document templates and data entry forms, connect to more types of databases, and manage your print environment.

Print Portal redesign

PP2020 - Icon View_Edited_2

Print Portal is redesigned to have a responsive modern UI, improved performance, and streamlined functionality.

Secure Internet printing

Print operators can use any web browser to securely connect their client computers (over HTTPS) to a website that is hosted by the Print Portal web server. They can then use Print Portal to find and open the documents that they need, select a printer to send the print job to, and enter data into the data entry form as applicable at print time. Client computers do not have to have BarTender installed.

Administrators can enable authentication and single sign-on (SSO) by using Microsoft Internet Information Services (IIS) and Active Directory Federation Services (AD FS) for Windows authentication. They can also restrict access to document folders to only certain users and groups.

Driverless printing

The web server/client model enables driverless printing, in which print jobs are streamed directly to the printer without a need to install a printer driver on the server. Additionally, the network can be configured so that print operators can send print jobs to any printer in the network, whether local or remote.

PDF printing

Print to PDF is now supported directly from Print Portal.

Security and authentication

Internet printing now fully supports Secure Sockets Layer (SSL) and TLS encryption. Support is added for SSO by using IIS or AD FS. For Windows authentication, make sure that the Windows Authentication IIS feature is enabled, and then turn off Anonymous Authentication and enable Windows Authentication for the website inside IIS. For AD FS integration, manually add a new relying party trust for the root Print Portal URL. For more information, refer to the Print Portal FAQ.

Administrators can configure a new option that requires a user to re-submit authentication credentials after a specified time-out period elapses.

5 Logoutafter Edited 2

Administrators can configure a new option to password-protect the Administrative Settings page.

6 Require Password Edited 3
Usability improvements

Grouping and sorting options are added to make it easier to organize your folders and documents and to find the document you need. You can group by author, category, tag, or product, and sort by name, date created, or date modified.


Administrators can configure a new option that determines whether the print operator is returned to the document selection page after a print job runs. In some cases, the print operator needs the document to stay open after the print job runs, such as when a label must be printed again with different data or to a different printer. This new option makes this scenario possible.

Support is added in Print Portal for the Repeat data entry until cancelled print option in the Print dialog in BarTender Designer. This option specifies that when a print job is complete, a new print job is automatically run. This means that you need not manually restart a print job when you run multiple consecutive print jobs that use the same BarTender document.

Support is added for form-level actions that are configured in BarTender. These actions help you to manage forms and print jobs and to communicate information to print operators at print time. For example, you can configure actions to reset or clear form data, continue or cancel a print job, display a message, and more.

Librarian support

Librarian is the BarTender suite companion application that provides a content management system for your BarTender documents. When you use Librarian, you create a revision history for your documents that tracks all the changes to the document design and all the user comments that accompany each revision. You can also use Librarian to create workflows so that you can easily manage a document’s status as it moves from first draft to final published state.

The Librarian revision history and any workflow states are exposed in Print Portal, so users can verify the document version, compare revisions, and add revision comments as needed.

10 - ViewDetails_Edited_2

Any changes that are made in Print Portal (such as adding a comment or changing a workflow state) are immediately reflected in Librarian, and vice versa. To perform these Librarian functions on the client requires only the web browser, which reduces or eliminates the need to install a full version of BarTender.

Librarian performance is significantly improved in BarTender 2020 Preview 1 due to database improvements that greatly increased the speed of read operations.

BarTender 2020 Preview 1 provides several new database option improvements.

New database types

Support is added for Excel Online, JSON, and Google Sheets databases.

11 - DataConnectors_Edited_2

Support is added for embedded sample data in text and XML database connections. This means that when you use the Database Connection Setup wizard to connect to a text or XML database, you can now embed sample database data directly into the wizard. No external sample data file is required when you do this.

Other improvements

In the Database Setup dialog, a Row column is added to the record browser that appears on the Record Browser property page. This column specifies row numbers for the data, similar to the numbering that is available in the record picker control for data entry forms.

12 Recordbrowser Edited 2

The BarTender /d command-line parameter is expanded to support not only text files but also XML, JSON, SAP IDoc, and Excel database connections. The /dd parameter is also modified to automatically delete all files that were specified by a /d parameter when BarTender is finished with them.

BarTender Designer improvements

New and updated features are added to BarTender Designer for both templates and data entry forms.

Template improvements

A new Print Job Field data source type is added for “Database File Name.” Now, the name of the database file that the BarTender document is connected to can be displayed as a print job field for a text object on a template.

Support for automation for table object databases is added. In BarTender 2019, table objects were added, to which databases could be connected and used as data sources. However, it was not always easy to use automation with these databases. With the BarTender 2020 Preview 1 improvements, automation can now be used to dynamically change the record set for a table object by using BTXML and the Integration platform.

Data Entry Form improvements

Several data entry controls (record picker, list box, dropdown record picker, and dropdown list box) now have Remember search and/or Remember filter options. You can use these options to specify that the most recently used search criterion or filter is used for these controls for the next print job that you run.

A default Back button is added to standard data entry forms. Print operators can use this new button to page backwards through multiple forms if they need to change the entered data for a record rather than having to start over.

For data entry controls that support borders (such as the text input box, list box, date picker, and so on), a new Show Border option is added, which you can use to show or hide the borders of the control.

In a scenario in which a data entry form control is configured to prompt the print operator to input data for every database record, you might want to provide an indication of which database record is the currently selected one. To do this, you can link a text input box control to the database field that you want to monitor and configure the control to be read-only. You can use the new Show Border option to remove the borders of the text input box to make it more readable at print time.
Back to Top

Integration Builder improvements

New integration message logging options are added so that administrators can choose whether to log integration events and actions. For large load configurations, these new options help you manage the size of the system database. These logging options are exposed on the System Database page in Administration Console.

14 Adminconsolemessagelogging Edited 2

A new PowerShell Script Editor is now available from the Power Shell Command action. You can use this editor to create and edit Windows PowerShell commands when the action is configured to use embedded commands.

PowerShell is also added as a syntax highlighting option for the Visual Basic Script Editor. This new feature allows more of the script to be visible in the user interface.

14 Powershellscripteditor Edited 2

Administration Console improvements

An option is added in Administration Console to turn off printer redirection. There are several scenarios in which you might want a print job to fail rather than be redirected to a different printer (for example, when a printer name is misspelled or when you want to know that a printer has gone into an error state).

This new option supports these scenarios by allowing such print jobs to fail.

15 Adminconsoleprintsettings Edited 2

A new Set as template for new users feature makes it possible to specify that every new user or group that you add is automatically assigned the same permissions as a particular existing user or group. This feature can save time when you need to add multiple users or groups that are to have the same permissions. This new feature is located on the User Permissions page under the Security node in Administration Console. To access it, right-click the user or group that you want to use as a template.

16 Adminconsoleusersettings Edited 2

Predefined stocks are added for Toshiba TEC printers. These stocks are exposed on the Predefined Stocks mini-tab on the Stock tab in the Page Setup dialog.

For continuous inkjet (CIJ) printers, BarTender is updated so that users can now change the width of a predefined raster size to accommodate CIJ printing.

Some printers can print the abbreviated day of the week (such as "Fri" for "Friday") by using the printer clock. Support is added in BarTender for this date format.

Some printers can print a one-digit year by using the printer clock. Support is added in BarTender for this date format.
Back to Top


The Print Batch action is renamed to "BarTender Process." This action can now print multiple BarTender documents in a Process Builder process file (.btproc) or a legacy Batch Maker batch file (.btbat).
Back to Top

Top issues addressed in Preview 1

  • Improved Print Portal and Librarian performance issues
  • Performance improvements to all BarTender file -> open dialogs
  • Added a configurable option in Print Portal to return to the document selection page after printing
  • Print Portal now supports the "Repeat data entry until cancelled" BarTender Designer print option
  • Added support for single sign-on and Print Portal using IIS Windows authentication and ADFS
  • Made improvements in Print Portal to be fully compatible with HTTPS
  • Added an option to turn off printer redirection in Administration Console
  • Made improvements to data entry forms and input in Print Portal
  • Added functionality to better organize folders and documents in Print Portal
  • To see a complete list of all fixes in Preview 1 click here.


When you install BarTender 2020 Preview 1, you have the option to install the redesigned Print Portal Internet printing solution. This document answers frequently asked questions (FAQ) for IT technicians, BarTender administrators, and partners about how to configure, use, and troubleshoot your Print Portal installation.

How to use Print Portal

Questions about how to set up and use Print Portal for Internet printing include the following:


What is Internet Printing?

Internet printing is a process in which users can select a document that is hosted on a web server or service and then print it on the printer that is connected to their local computer or other device. In BarTender 2020 Preview 1, the server that hosts Print Portal can be manually configured to provide an HTTPS connection that supports Internet security.
Back to Top

How do I install Print Portal

You can install Print Portal at the same time that you install BarTender 2020 Preview 1, or you can install it on an existing BarTender 2020 Preview 1 installation.

To install Print Portal when you install BarTender, follow these steps:

  1. Double-click the BarTender installation. The BarTender Setup wizard starts.
  2. On the welcome page of the BarTender Setup wizard, read and accept the license agreement, click to select the Specify advanced installation options check box, and then click
  3. On the Advanced Installation Options page, click to select BarTender with Print Portal, specify a folder to install to, and then click
  4. Complete the remaining pages in the wizard

To install Print Portal on an existing BarTender installation, follow these steps:

  1. Browse to and then double-click the BarTender installation package file. Alternatively, in Windows Control Panel, click Programs, click Uninstall a program, click BarTender, and then click Change.
  2. In the User Account Control dialog, click Yes. The BarTender Setup wizard starts.
  3. Click to select Modify, and then click
  4. On the Advanced Installation Options page, click to select BarTender with Print Portal, and then click
  5. Complete the remaining pages in the wizard
    Back to Top

After you install Print Portal, you can access it on any client by opening a browser window and then entering the following URL:


Alternatively, you can click the Start icon in the bottom left corner of the Windows user interface, click the BarTender 2020 Prevew 1 icon in the apps list, and then click the Print Portal icon to start Print Portal in your browser.
Back to Top

How do I print to an Internet client printer?

First, install the BarTender Client Print service on the client device, and then add the printers that are connected to the client device to the service. Then, use Print Portal to locate the document that you want. To print the document, click it. Alternatively, click , and then click Print. On the Print page, select the printer that you want and configure other options, such as the number of copies that you want to print.

On the server side, after the Client Print service is installed on the client device and the printers that are connected to that device are added to the service, those printers that are shared on the client are also available for printing from the server.
Back to Top

Do I need to install a printer driver on the server?

No. Print Portal supports “driverless printing.” This means that as long as the printer is connected to the client device and is in the list of available printers on that device, Print Portal can stream an image of the selected document to that printer.
Back to Top

How do I set up and configure the BarTender Client Print service?

Print Portal uses the BarTender Client Print service to connect the client to the web server host and expose the available printers on the network. When you click a document in the document selection pane on the Home page in Print Portal, the Print page opens and displays the status of the Client Print service. The first time that you do this, a banner appears that notifies you that the service is not yet installed. Click Install to download and install the service.

The BarTender Client Print service automatically connects the web server to the client by using the Print Router URL that is displayed on the Client Printing property page of the Administrative Setup page.
Back to Top

Print Portal provides a browsing method and a search method for locating the BarTender documents that you want to print. You might find it easier to locate your documents by using one method instead of the other, or you might use a combination of the two methods.

For example, if you have only one or two folders or a small number of documents, you might find it quicker to browse to the appropriate folder in the folder navigator and then select the document in the document browser.

If you have many folders and/or documents, it might be quicker to use the search method, assuming that you know the name of the document that you want to print, the name of the folder that contains the document, or a tag that the document is associated with. The search function does not work for content that is contained in a document.
Back to Top

How do I enable Internet printing?

On the server, click to select the Enable client printing check box on the Client Printing property page of the Administrative Setup page, and then enter the web server name and Print Router URL. The Print Router URL is used by the Client Print service to connect the client to the web server.

On the client, make sure that you are connected to the Internet, that you have a valid Print Router URL, and that the BarTender Client Print service is installed.
Back to Top

How do I configure Print Portal to support Internet client printing over the Internet (such as a wide area network [WAN])?

Every organization approaches the question of how to secure its public-facing web assets in its own way. However, a common need is to make sure that the communication channel for Internet printing is as secure as is economically possible. For this reason, HTTPS is typically used.

It is the responsibility of the organization that deploys Print Portal to obtain and install the underlying HTTPS certificate, which requires Microsoft Internet Information Services (IIS) to be installed as well. For more information, visit the following Microsoft website:
Back to Top

How do I design a BarTender label template that uses a data entry form to print to Internet client printers?

Creating a BarTender label template that uses a data entry form to print to Internet client printers is no different from creating any BarTender label template that uses a data entry form to print.

Print Portal automatically displays any data entry forms that are included in the BarTender document when you run a print job. Data entry forms are also displayed when you preview a document before printing it.
Back to Top

What is driverless printing?

Consider a scenario in which a printer is connected to the client device but the Print Portal server does not have a driver installed for that printer. In this case, driverless printing occurs as the server streams a printable file to the client printer without using the driver.
Back to Top

I have my own web application, but I want to interface programmatically with a Print Portal API. How do I do this?

The Print Portal API is currently planned to be released in BarTender 2020 Preview 2.
Back to Top

I have my own web application, but I want to interface programmatically with a Print Portal API. How do I do this?

First, make sure that the Windows Authentication Internet Information Services (IIS) feature is enabled in Windows. Then, in IIS, turn off Anonymous Authentication and enable Windows Authentication for the Print Portal website. The Print Portal API is currently planned to be released in BarTender 2020 Preview 2.

How can I Configure Print Portal to automatically sign on by using Windows credentials?

For security reasons, the Windows Authentication feature in IIS is turned off by default. To enable this feature, follow these steps in Windows:

  1. In Control Panel, click Programs, and then click Turn Windows features on or off to open the Windows Features
  2. In the Windows Features dialog, expand Internet Information Services, expand World Wide Web Services, expand Security, and then click to select the Windows Authentication check box.
  3. Click OK.

After you enable Windows Authentication, open the IIS Management Console, locate the Print Portal website, and then double-click to display the authentication settings. Set Anonymous Authentication to Disabled, and set Windows Authentication to Enabled.

*If you are using Mozilla Firefox as your browser, you need to make a configuration change to automatically pass Windows credentials. For more information, visit the following website: indows+Authentication+%28IWA%29+in+Mozilla+Firefox

Print Portal also supports Active Directory Federation Services (AD FS) integration as a single sign-on (SSO) solution. To configure this, use the following procedures:

In the AD FS Management snap-in for the Microsoft Management Console, add a new relying party trust. To do this, use the Add Relying Party Trust wizard to configure the following settings:

  1. Click to select the Enter data about the relying party manually.
  2. Make sure that token encryption is not specified.
  3. Click to select the Enable support for the WS-Federation Passive protocol check box, and then enter the root URL of Print Portal as the relying party protocol URL.
  4. Click to select the Open the Edit Claim Rules dialog for this relying party trust when the wizard closes check box, close the wizard, and then add a claim rule to transform the SAM- Account-Name LDAP attribute to the Name ID claim.

In Print Portal, follow these steps:

  1. Stop the application.
  2. Make sure that the website is configured to use an HTTPS. An HTTP binding will not work.
  3. Edit the application's config.xml
  4. In the Authentication node, make sure that Enabled is set to "true", and then change Mode to "ADFS".
  5. Provide the metadata address that corresponds to the ADFS.
  6. Enter the root Print Portal URL in the RelyingPartyURL field. This URL must exactly match the URL that you configured in the AD FS Add Relying Party Trust wizard.
  7. Start the application pool.

For more information, visit the following Microsoft website: federation?view=aspnetcore-2.2
Back to Top

How to Troubleshoot Print Portal

Questions about how to troubleshoot Print Portal include the following:

  • I sent a print job to my client printer but no items were printed.
    • Try restarting your computer or printing to a different printer.

  • I try to print a document but my client printer is not displayed in the printers
    • On the Administrative Setup page, make sure that the printers that you want to share are selected.

  • I try to print a Print Portal document by using my portable device (such as an iPad), but I do not see my Internet.
    • This is currently an unsupported scenario. Print Portal does not support iOS devices.

  • I darkened my printer's thermal output option, but the printed label was unchanged.
    • If changing the darkness settings on the printer does not change the output, refer to the printer manufacturer's documentation.
  • It takes a very long time for my label to be printed after I click Print.
    • Try restarting the browser and reloading Print Portal.

  • What IP ports are being used by Print Portal and the BarTender web print client?
    • Port 5952 is used by the client service to communicate between localhost and the client service. Typically, port 80 is used for HTTP and port 443 for HTTPS.
  • Where can I look for detailed log files for both Print Portal and the BarTender web print client?
    • The log folders for these applications contain the log files.
  • My BarTender web print client configuration is asking for a Print Router URL. What is this and where can I find it?
    • The Print Router URL is what is used by the BarTender Client Print service to connect the web server with the client. It is located on the Client Print Settings property page of the Administrative Setup page. This URL is configured by the administrators of the website that is hosting Print Portal.
  • My company requires all web applications to be HTTPS-compliant. How do I configure Print Portal to work with HTTPS
    • Obtain and install an HTTPS certificate, and then enable Transport Layer Security (TLS) 1.2 on the site servers and remote site systems. For more information about how to do this, visit the following Microsoft website: server

  • I try to install the BarTender web client, but the installation process fails. Now what?
    • Contact our Technical Support team. More information is needed to determine the next steps.
      Back to Top


Additional resources

  • BarTender Software Website

  • BarTender Support Center
Back to Top

An Error Occurred.