The following hotfix is available for Appian 20.3.

If you have a self-managed installation, you can view your current Appian version by logging into your Appian environment as a designer or system administrator and clicking the navigation menu > About Appian

This is a cumulative hotfix that includes all resolved issues listed below in a single download and set of instructions. This hotfix is required for any Appian 20.3 installations not currently up to date with the latest hotfixes. After installing, you will be running on Appian 20.3.625.0.

20.3.625.0 Hotfix

See the Installation section at the bottom of this page for instructions on how to install this hotfix.

Resolved issues


  • Security Updates - Medium

  • AN-179530 - Medium
    Process model version comparisons now detect and highlight changes made to data inputs of smart services accurately.

  • AN-179365 - Low
    Tooltips in the source and target plug-in version columns in the deployment details view now display the accurate environment information.


  • AN-179059 - High
    The status script no longer show an engine in the RUNNING state if that engine had errors during startup.

  • AN-179175 - Medium
    Read-only grids that use a record type as the data source now properly display any validations configured in the validations parameter of the grid.


  • AN-179475 - Medium
    Data source connections are properly closed when the data sources are updated or deleted in the Appian Administration Console.


  • AN-179407 - High
    Fixed issue with web API responses


  • Security Updates - Low

  • AN-176178 - Medium
    Fixed the order of the columns in records.csv to fix an error in capturing records data metrics.

  • AN-177533 - Medium
    MariaDB database deployed with Appian Cloud sites has been upgraded to version 10.5.8.

  • AN-177777 - Low
    Records using rv!identifier expression in their title now display correctly in the Record Picker Component suggestion list.

  • AN-178507 - Low
    Logging mechanism has been updated so that the application server does not unnecessarily log "duplicate entry" error when a document is downloaded from the document viewer.

  • AN-178677 - Low
    Query error messages now display more information

  • AN-178817 - Low
    Improved exception logging


  • Security Updates - High

  • AN-177269 - Medium
    For Appian Cloud sites, the MariaDB driver has been upgraded to MariaDB Connector/J 2.7.2

  • AN-177408 - Medium
    Fixed an issue where file uploads would sometimes throw indexing errors if form data was populated by a records query.

  • AN-178360 - Medium
    Fixed an issue which caused an error when adding a new row in the Request Form interface template.

  • AN-178797 - Medium
    Users whose locale is set to something other than the primary site locale can now create and save new process models from the Appian Designer space.


  • Security Updates - Medium

  • AN-176667 - High
    Reconcile Doc Extraction selection tool now properly selects token data.

  • AN-174028 - Medium
    Fixed an issue that caused cache corruption and prevented cache cleanup from running properly on some machines. Also fixed an issue where threads could become stuck while running cache cleanup.

  • AN-174840 - Medium
    Added work to support Smooth Mobile Onboarding feature on older servers

  • AN-175359 - Medium
    Improved screen reader performance of the user options menu.

  • AN-177620 - Medium
    When a package with multiple database scripts is redeployed to another environment, the scripts will now be displayed in the order of execution.

  • AN-174208 - Low
    The performance of a!forEach() has improved with a list of record data types in the items parameter.


  • Security Updates - High


  • Security Updates - High

  • AN-176409 - High
    Application Security Summary is now properly displayed without errors. Prior to this fix, objects with no security caused the security summary to time-out.

  • AN-158987 - Medium
    Fixed an issue where extra padding is applied around the header content layout in user input tasks.

  • AN-167252 - Medium
    Fixed an issue where selecting a record type as the data source for a read-only grid in Design Mode generated grid columns incorrectly if the grid columns defined on the record type are not wrapped in a list.

  • AN-176152 - Medium
    Fixed an issue where extra padding is applied above the content in header content layout in record views when there is no header.

  • AN-175315 - Low
    Added a new method to the public Java API called ProcessExecutionService.getTaskOpaqueUri(). This method returns a link to a task using an opaque URL, which is required for task links on new sites as of Appian 20.3 or later.

  • AN-175842 - Low
    For High Availability configurations, all engines automatically restart, when safe and without disruption, after checkpointing. This allows the engines to reclaim unused memory which previously could not be released until a scheduled or forced restart of the engines.


  • Security Updates - Critical

  • AN-174630 - Medium
    When a data source is deleted from admin console, application server is restart is no longer required to remove the information about the old connection in cache.

  • AN-175574 - Medium
    The index() function with an empty list default value now properly returns a list of empty lists when indexing into the data parameter of a!queryRecordType's output with a record field that was not selected in the query.

  • AN-176180 - Medium
    Fixed an issue where trailing commas in record view expressions could sometimes cause unexpected evaluation errors.

  • AN-174875 - Low
    Fixed an issue that prevented Appian Data Server from restarting under certain conditions.

  • AN-175330 - Low
    A race condition that could prevent an engine from checkpointing and shutting down has been eliminated.

  • AN-175819 - Low
    AE endpoint to expose documentation information related to RPA and AE, based on runtime versions.


  • Security Updates - High

  • AN-175301 - Medium
    Import packages containing objects with circular record type references no longer fail during import.

  • AN-175464 - Medium
    Fixed an issue where linked rich text icons in modals did not show their tooltips.

  • AN-172248 - Low
    Appian now warns developers against using rv!record without record field references in related action context expressions.

  • AN-174986 - Low
    The Kafka component used by the Internal Messaging Service has been upgraded to version 2.7. This upgrade makes these services more resilient in the event of network, OS process, or machine hardware failures.

  • AN-175248 - Low
    MariaDB upgrade compatibility checker now checks for the existence of the function ANY_VALUE in Appian Cloud MySQL Database.

  • AN-175268 - Low
    Application server logs now record debugging information while opening or saving an interface in the interface designer, when the logger is configured at DEBUG level.


  • AN-175075 - Medium
    Fixed an issue that prevented the user from going back to the login screen after resetting their password


  • Security Updates - Critical

  • AN-173802 - High
    Appian tasks are now properly displayed in Microsoft Outlook emails when using the Task Viewer Add-in.

  • AN-175193 - High
    Custom plug-ins that use classes in the javax.wsdl package will now load properly again. This restores the behavior to be consistent with Appian version 20.2 and earlier.

  • AN-174532 - Medium
    Fixed an issue that caused unexpected empty areas to appear at the bottom of interfaces when grids are collapsed within boxLayout/sectionLayout

  • AN-170770 - Low
    Process Models no longer incorrectly show warnings for missing referenced items. Prior to this fix, some process models and their process instances unexpectedly displayed this warning due to a bug in unarchiving processes. That bug was fixed in 20.2 Hotfix Package D (see AN-165870).


  • Security Updates - Critical

  • AN-173802 - High
    Appian tasks are now properly displayed in Microsoft Outlook emails when using the Task Viewer Add-in.

  • AN-172298 - Medium
    Updated record lists now have the correct memory limit for export to Excel. This updates behavior to be consistent with Appian 20.2 and earlier.

  • AN-172954 - Medium
    Fixed an issue that caused table editing to break in Document Extraction reconciliation tasks after the nested CDT had been modified.

  • AN-173182 - Medium
    Replication timeouts during a checkpoint no longer cause an engine to failover.

  • AN-174991 - Medium
    Fixed an issue where the search filter on a record grid with nested data would not be correctly applied in exported Excel files.

  • AN-172594 - Low
    Fixed an issue where submitting record action dialogs on a record view would not update the UI correctly when using rv!record in your view expression.


  • Security Updates - Medium

  • AN-173741 - Medium
    The navigation menu icon and user profile photo in the navigation bar now have a more prominent keyboard focus style.

  • AN-173971 - Medium
    Fixed an issue where the scroll position was not automatically resetting to the top when switching between site pages.

  • AN-174093 - Medium
    Updating CDTs now have improved logging to record unexpected updates to any older versions of the CDT. These events will be available in the Process Design engine log.

  • AN-174236 - Medium
    Fixed an issue where date range filters did not open when used on a record grid within a related action that displays in a dialog.

  • AN-169758 - Low
    For synced records, data types in the Data Model tab of the Record Type Designer now display properly in languages other than English.


  • Security Updates - High

  • AN-173190 - High
    Submitting a record action component dialog and then quickly opening another record action dialog no longer causes interfaces to become unresponsive.

  • AN-173962 - High
    Fixed an issue with WSDL consumption which could result in thread exhaustion in cases where the web service was slow to respond.

  • AN-174329 - High
    Fixed an issue that prevented DocuSign integrations from downloading envelope documents larger than 5MB.

  • AN-173754 - Medium
    Fixed an issue where a form could not be submitted if it contained a local variable that's a dictionary with an empty string as a keyword.

  • AN-174009 - Medium
    Fixed an issue where screen readers did not announce a required picker field as required if the number of selections already reached the maximum.


  • AN-173897 - High
    Fixed an issue which caused queries to fail in a!queryEntity when the name of a selected field was the same as certain function names.

  • AN-173649 - Medium
    Fixed a keyboard navigation issue for rich text icons with a link and a caption where the caption would only appear after a second tab press on the icon.

  • AN-174002 - Medium
    Improved the performance of the Application Designer and object designers, especially in environments that have hundreds of records and reports.


  • Security Updates - Low

  • AN-172803 - Medium
    Fixed a display issue with the expression editor icon in the process modeler when viewed in Internet Explorer.

  • AN-169812 - Low
    a!queryRecordType now properly returns an error code when querying synced record types that return more than the sync memory limit (5 MB).

  • Security Updates - Low

  • AN-167790 - Medium
    Added a guardrail to prevent ADS queries from using more than 5MB of memory.

  • AN-173188 - Medium
    Fixed an issue that caused page content at the bottom of multi-page sites to be covered by the navigation bar on narrow screens on non-Chrome browsers.

  • AN-173469 - Low
    When Oracle is the primary data source, the sites metrics log sites.csv is now correctly populated and the application server log will no longer display related errors.

  • Security Updates - Low

  • AN-168877 - Medium
    Process history now properly displays a user whose username was changed. Prior to this fix, process history would display a blank user for users whose username was changed.

  • AN-171274 - Medium
    The performance of querying records that have a default filter configured with an 'in' operator that has many values has been improved.

  • AN-164728 - Low
    Users with a null username can no longer be reactivated using the Reactivate User Smart Service. Prior to this fix, it was possible to reactivate a user with a null username causing errors while accessing the user.

  • AN-170066 - Low
    Fixed an issue that prevented system administrators from logging in when they are not part of the Designer and Application User groups.

  • AN-170998 - Low
    Fixed an issue where package inspection did not identify some new or updated record fields as missing precedents when using these fields in record field references.

  • AN-172810 - Critical
    return active users for Docusign Send Envelope integration

  • AN-166239 - Low
    Fixed an issue which could cause spikes in memory usage or log extraneous error messages when editing interface objects.

  • Security Updates - Critical

  • AN-172533 - High
    Fixed an issue that caused the Application Portal to appear blank if it contained a channel that had a process report with an indicator pointing to a non-image document.

  • AN-170791 - Medium
    When syncing a record type fails due to a deleted column from the cloud database, the user will receive an error message saying, "Further details indicate that though the record type is marked as synced, its data has not yet been synced or its existing synced data has been invalidated." The error behavior has not changed, however, the previous error message did not have the correct explanation for the error.

  • AN-165165 - Low
    When duplicating objects, developers are no longer added to the security rolemap as an administrator if they already belong to a group with administrator permissions.  

  • AN-168586 - Low
    When deploying applications to a target environment, developers are no longer added to the application's security rolemap as an administrator if they already belong to a group with administrator permissions.

  • AN-171145 - Low
    Duplicating a process model now correctly generates new node UUIDs.

  • AN-171833 - Medium
    Fixed an issue that caused interfaces to become unresponsive after submitting a record action dialog and then quickly opening another record action dialog.

  • Security Updates - Critical

  • AN-171245 - High
    Fixed an issue that prevented users from accepting tasks with attachments that had been assigned to them in portal

  • AN-170363 - Medium
    Fixed an issue that caused interfaces to become unresponsive after submitting a record action dialog and then quickly opening another record action dialog.

  • AN-170986 - Medium
    Fixes delimiters for multi-statement SQL

  • AN-171219 - Medium
    When executing database scripts via compare and deploy, certain scripts will now execute successfully. These are scripts that use a regex character as the custom delimiter, have multiple statements using the custom delimiter, or have DELIMITER declarations commented out.

  • AN-171665 - Medium
    Update RPA Execute Process Integration to fix issue of an empty dropdown parameter value causing error

  • Security Updates - Medium

  • AN-170569 - High
    Fixed an issue that prevented site upgrades when an unsupported locale is used.

  • AN-170688 - High
    ElasticSearch version has been upgraded to resolve the issue of high heap usage by Search Server.

  • AN-170763 - High
    Fixed an issue that caused some functions in expressions to be replaced by their previous Appian version.

  • AN-166469 - Medium
    Fixed an issue which prevented an interface from being exported when it used a rule input of type Map with no default test values.

  • AN-170788 - Medium
    Fixed an issue that slowed down the download of large deployment packages in the deployments view.

  • AN-170986 - Medium
    Fixes delimiters for multi-statement SQL

  • AN-170763 - High
    Fixed an issue that caused some functions in expressions to be replaced by their previous Appian version.

  • AN-170593 - High
    Fixed an issue that caused a performance degradation during inspection of application packages.

  • AN-55085 - Medium
    The Render Phase Mean Time metric is now accurately logged in rest_details.csv. Prior to this fix, the metric was logged incorrectly in certain scenarios, causing its value to be larger than the Mean Total Time.

  • AN-163412 - Medium
    Fixed an issue where invalid field references in record list expressions would not show evaluation errors in record type designer.

  • AN-169290 - Medium
    The Infrastructure page in the Administration Console will load successfully even when the user account that is set as the deployer is deactivated.

  • AN-169790 - Medium
    Fixed an issue where chart tooltips did not show in dialog windows. This updates behavior to be consistent with 20.2 and earlier.

  • AN-170457 - Low
    Fixed a display issue where a direct deployment's details page showed its database scripts in a different order from which they were originally specified and executed.

  • AN-170521 - Low
    The stamp component inline documentation has been updated to provide a link to the stamp product documentation page

  • AN-170527 - Low
    Fixed a display issue where an error dialog is shown after updating a SAML IdP metadata file in the Administration Console, although the change is successfully saved.

  • AN-170273 - High
    Fixed an issue that prevented portal forms from loading on IE11.

  • AN-170394 - High
    Fixed an issue that caused processes using the Send Email Smart Service to fail due to high load on the engines.

  • AN-170557 - High
    In compare and deploy, the inspection timeout has been increased to 5 minutes to account for larger deployment packages.

  • AN-170158 - Medium
    Fixed an issue where document extraction table auto-prediction functionality was not enabled by default on some cloud sites.

  • AN-148898 - Low
    Fixed an issue where the French (Canada) translation for the Date & Time component placeholder was incorrect resulting in selected value validation errors.

  • AN-170074 - Critical
    Fixed a bug that prevents an Appian Cloud site from upgrading to MariaDB.

  • AN-166913 - Low
    When syncing a record type's data fails due to a change in the schema of the RDBMS table or Salesforce object it is synced to, the error displayed now contains more details on the exact reason for the sync failure.

  • Security Updates - Critical

  • AN-169870 - Critical
    Packages containing 2 or more record types which use record type object references to reference each other can now be deployed successfully.

  • AN-167768 - Medium
    Resolved an issue where table values were not always being accurately auto-populated in Appian document extraction.

  • AN-169427 - Medium
    Fixed an issue where the Cards as Choices pattern caused a publish error in Process Modeler.

  • AN-169607 - Medium
    System branding settings now import successfully to environments on version 20.3 when the source environment is on an older version.

  • AN-169651 - Medium
    Fixed an issue which caused unexpected design guidance warnings to appear during deployment inspection.

  • AN-169808 - Medium
    Fixed an issue which prevented refresh intervals from updating a local variable’s value while testing an interface.

  • Security Updates - Critical

  • AN-169523 - Critical
    Fixed an issue with data server migration that prevented data server from starting up on self-managed windows installation of Appian.

  • AN-169464 - High
    Process History details can be safely accessed for processes with process variables of type 'dictionary'. Prior to this fix, accessing history for such processes would cause the process execution engine to rollback in some scenarios.

  • AN-169501 - High
    Fixed an issue that caused the interface designer to error out in certain scenarios when multiple developers open the interface designer at the same time.

  • AN-156075 - Medium
    The Export Data Store Entity to Excel or CSV smart services will no longer execute indefinitely when exporting a database view that has a null primary key. Instead, these smart services will fail appropriately at run-time and display a corresponding process error message.

  • AN-160691 - Medium
    Fixed an issue that resulted in the mobile user needing to select the intended mobile application during the user authentication process

  • AN-167152 - Medium
    User filters for existing service-backed record types are now properly updated when clicking the update button in record type designer.

  • AN-168642 - Medium
    Fixed an issue where an empty list of records stored in a local variable could cause an unexpected error when editing an interface.

  • AN-168338 - Low
    Fixed an issue that prevented record syncs from completing successfully when the source contains atypically large rows of data.

  • AN-168635 - Low
    The keyboard focus indicator is now visible for the 'Skip to main content' link on Tempo and Sites.

  • Security Updates - Medium

  • AN-166394 - High
    Search server indexing process is now more robust to race conditions across nodes on a Highly Available Appian site.

  • AN-167283 - Medium
    Fixed an issue where navigating quickly between pages on a site could cause an unexpected error.

  • AN-167579 - Medium
    Renaming a user will no longer cause application users to lose their active form data.

  • AN-168174 - Medium
    Fixed an issue that prevented saving a value into an empty rule input whose type is a map or record data type.

  • AN-168251 - Medium
    Fixed an issue which caused the server to evaluate some expressions more slowly while under heavy load.

  • AN-168350 - Medium
    Objects referencing record types that are backed by a data store now import successfully even if the data store did not publish.

  • AN-165051 - Low
    Performance timings for a!queryRecordType are now reported properly in the "Descendant Functions and Query Rules" section of the Performance View.

  • AN-168003 - Low
    Unused configuration files have been removed from the Service Manager conf directory.

  • AN-168255 - Low
    Fixed an issue where clicking the first time on a selectable grid row did not select it.

  • AN-168280 - Low
    Fixed an issue that prevented metrics for checkbox and selection tool extraction from being logged correctly.

  • AN-168554 - Low
    Fixed an issue with a broken documentation link in the Button Widget validation parameter.

  • Security Updates - High

  • AN-164717 - Medium
    Improved performance of casting a record data type to other data types

  • AN-165033 - Medium
    Improved performance of casting other data types to a record data type

  • AN-167570 - Medium
    Fixed an issue with user filters on read-only grids where the dropdown would close before users could select multiple options.

  • AN-168025 - Medium
    Fixed an issue that prevented Search Server settings from getting applied to a site.

  • AN-168169 - Medium
    A system error will no longer occur during Inspection in Compare and Deploy when certain calls to the target environment have timed out.

  • Security Updates - High

  • AN-162502 - High
    The engine startup sequence has been streamlined so that if a problem occurs during startup, it will fail quickly rather than after a prolonged timeout. Previously, certain conditions could make engine startup hang for up to 10 minutes before failing.

  • AN-164708 - High
    Improved performance of larger interfaces when the system is under high load.

  • AN-161920 - Medium
    Fixed an issue where rule renaming did not automatically rename rules called in the expression editor in the record header configuration.

  • AN-161946 - Medium
    Fixed an issue where grids with certain pagingSaveInto configurations validated on page or sort action. This updates behavior to be consistent with Appian 20.1 and earlier.

  • AN-162346 - Medium
    Fixed an issue that prevented process model comparisons from rendering when sub-process nodes contain certain custom data type inputs.

  • AN-163423 - Medium
    Health Check now gracefully handles the presence of multiple gzip files in the logs directory.

  • AN-163494 - Medium
    Reduced memory footprint of the Read-Only Grid Component.

  • AN-163516 - Medium
    An issue resulting in an excessive number of threads in a waiting state on a site after the usage of data stores has been resolved.

  • AN-163541 - Medium
    It is no longer allowed to create a business data source in the Admin Console with the same name as the Appian Cloud provided business data source.

  • AN-163562 - Medium
    The From address for the forgot password email now matches the site name configures on the branding page of the administration console.

  • AN-164662 - Medium
    Fixed an issue that occasionally caused types to be cached incorrectly in the system on appserver startup.

  • AN-158574 - Low
    Removed a broken documentation link from expression-backed records created prior to 18.3

  • AN-161252 - Low
    Manage Test Cases now displays long expression rule names correctly in the Test Case Results pane.

  • AN-164714 - Low
    Change the Process Model Recommendation weighting file to the .weights format.

  • AN-168212 - Low
    Fixed an issue where data types that contain certain simpleType and other XSD elements could not be opened in the Data Type Designer.


Perform the following steps to apply the hotfix:

  1. Stop Appian. See Starting and Stopping Appian for detailed instructions:
    1. Shut down the application server.
    2. Shut down the search server.
    3. Shut down the data server.
    4. Shutdown all Appian Engines, ensuring that the engines are checkpointed upon shutdown.
  2. Back up your existing Appian instance. See Backing Up Your Existing Appian Instance for instructions.
  3. Unzip the contents of the archive into your <APPIAN_HOME> directory.
  4. Run the deleteFiles script (deleteFiles.bat on Windows, on Linux) that is now located in your <APPIAN_HOME> directory.
    • If the script reports that some files were not deleted, address the reason for the failure (common causes listed below), and run it again until it no longer reports failed deletions.
    • Common causes of failed file deletion include:
    • The file is open in another window or process
    • The file is locked
    • You do not have permission to delete the file
  5. Unzip the contents of the archive that is now located your <APPIAN_HOME> directory.
  6. Run the installJdk script (installJdk.bat on Windows, on Linux).
  7. If you maintain customized or overridden Spring Security .xml files, merge them with the associated base files in the /deployment/web.war/WEB-INF/conf/security/ directory.
  8. Delete the deleteFiles scripts, the installJdk scripts, the OpenJDK .tar.gz and .zip files, and
  9. If you are using a Web server, copy the content of <APPIAN_HOME>/deployment/web.war to the folder where the Web server is getting the static resources. See Copy Static Resources to the Web Server for more information.
  10. Run the configure script to deploy your environment's configuration and re-configure any node names previously set by the configure script tools.
  11. Start Appian:
    1. Start the Appian Engines.
    2. Start the data server.
    3. Start the search server.
    4. Start the application server.

To determine if the Appian 20.3 Hotfix is deployed, open the file located in <APPIAN_HOME>/conf/. The contents of this file should match the following code sample:

Open in Github

On This Page