The following hotfix is available for Appian 21.1.

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 21.1 installations not currently up to date with the latest hotfixes. After installing, you will be running on Appian 21.1.385.0.

21.1.385.0 Hotfix

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

Resolved issues


  • AN-182195 - High
    Fixed an issue that prevented the application server from starting up due an error in acquiring change log lock

  • AN-181252 - Medium
    Upgrade Zookeeper to 3.7.0

  • AN-181942 - Medium
    The stability of the process execution engine has been improved. Prior to this fix, certain actions like starting a process, archiving or unarchiving a process could cause the engine to rollback, causing a temporary service outage for process execution.

  • AN-182236 - Medium
    Fixed an issue that prevented the OAuth Provider from redirecting back to the mobile app after authorizing the user.

  • AN-178286 - Low
    Fixed an issue which caused outdated validation errors to appear when uploading an XSD to create a new version of a data type.

  • AN-182313 - Low
    Fixed an issue where the unused rule input recommendation was incorrectly triggering in a specific case where the input was used as a rule reference.


  • AN-182651 - Critical
    For Appian Cloud sites, fixed an issue that prevented new high availability sites from starting up.


  • Security Updates - Low

  • AN-182083 - High
    Fixed a performance issue where related action start forms would re-query the record data on every interface evaluation.

  • AN-182179 - High
    Execution of processes with very large process variables now use less memory. Prior to this fix, such operations could cause the site to go out of memory in certain scenarios.

  • AN-180764 - Medium
    Fixes a bug that caused double slashes '//' to be interpreted as single slashes '/' in the URL of HTTP integrations.

  • AN-181352 - Medium
    Sort icons now display for legacy record list grids created with Appian 20.2 and earlier.

  • AN-181440 - Medium
    The performance of related actions configured without record type field references has been improved.

  • AN-181881 - Medium
    When a plug-in is selected in the precedents view of an object, the option to "Remove from Package” is now rightly disabled.

  • AN-179783 - Low
    Fixed an issue where inline documentation did not display in instructions or tooltips when editing the grid-style record list in the record type designer.


  • Security Updates - Low

  • AN-182214 - Critical
    Fixed an issue that caused some interfaces to break intermittently when displaying or interacting with the interface.


  • AN-179477 - High
    Plugins are no longer removed when certain app server connections fail

  • AN-176903 - Medium
    Data store operation is now more robust to database connection problems that might occur due to network issues.

  • AN-180967 - Medium
    Updated Apache PDFBox to 2.0.23 to address the out of memory exception experienced when loading certain PDF files.

  • AN-181036 - Medium
    In Internet Explorer, the in-line design guidance banner now displays correctly when the language is set to Arabic.

  • AN-181111 - Medium
    Fixed an issue with metric collection process

  • AN-181161 - Medium
    Fixed an issue where integration calls would fail when attempting to send a document that was created by uploading an email attachment to a process model.

  • AN-178571 - Low
    The import time out error message now directs designers to monitor deployment status in the deployments view.

  • AN-179907 - Low
    Performance optimizations for the Process Activity tab under Monitoring View

  • AN-181051 - Low
    Mid-tone accent colored text no longer changes to black on light colored backgrounds.

  • AN-181060 - Low
    Fixed an issue where a paging grid did not automatically return to the first page when refreshOnReferencedVarChange was false and a referenced variable in refreshOnVarChange was changed.

  • AN-181592 - Low
    Fixed a broken link in the inline documentation for the a!queryRecordType() function.


  • AN-180888 - High
    SAIL interfaces now use less memory when handling large data values.

  • AN-104684 - Medium
    The CDT relationship dialog now displays the correct instructional text

  • AN-173207 - Medium
    Improved screen reader support for grid paging controls.

  • AN-179162 - Medium
    Grids sourced from record data now properly display validations when using records features on the grid, such as export to Excel.

  • AN-180082 - Medium
    Fixed consistency issues with the now() expression function. The function now always produces the same Date/Time value for all invocations within a single request. In addition, the function no longer reuses stale values across distinct requests.

  • Security Updates - High

  • AN-180070 - High
    Fixed an issue that caused the values in the "Properties" column to be displayed incorrectly while viewing the history of a process in the Monitoring View.

  • AN-128790 - Medium
    Site page visibility now applies to system administrators on new environments. In order to preserve backward compatibility with the existing behavior, this will only be applied to upgrading environments when requested through a Support case.

  • AN-180492 - Low
    Selected mercury-style site tabs now properly display a prominent keyboard focus style on light navigation bars with dark selected highlight colors in IE11 and Edge.

  • Security Updates - Medium

  • AN-179318 - High
    Fixed an issue with a system cleanup operation that could prevent server starts in certain environments.

  • AN-179741 - High
    Resolved an issue that caused document extraction Google vendor jobs to error when Oracle is the primary data source.

  • AN-178369 - Medium
    Changed the environment variable SESSION_MANAGER, which enabled http session data to Redis, to APPIAN_SESSION_MANAGER to avoid any conflicts with duplicate variable usage across different software usage.

  • AN-179111 - Medium
    Improved screen reader support for rich text icons with captions and alternative text.

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

  • AN-179579 - Medium
    Fixed an issue where a!queryRecordType() did not return the sync error code when only querying for the primary key field of a record type with a failed sync.

  • AN-179665 - Medium
    The gmt() function now transitions into and out of Daylight Saving Time at the correct time in all time zones. This fixes an issue where the output of that function could be off by an hour for a period of time before or after the transition.

  • AN-180106 - Medium
    The RPA Connected System now correctly allows Document Types to be sent to RPA.

  • AN-180192 - Medium
    Fixed an issue that prevented clearing pre-populated values on "cards" style checkboxes.

  • AN-180564 - Medium
    Fixed an issue that caused extraneous errors to print in logs.

  • 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-180488 - Low
    When monitoring a process instance, the toolbar options for Spawned Nodes are now properly internationalized.

  • Security Updates - Low

  • AN-179337 - Critical
    Addressed an issue with a system cleanup operation that could prevent server starts in certain environments.

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

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

  • AN-174988 - Medium
    Resolved an issue in the process modeler that prevented the expression editor from rendering in the Appian forms designer.

  • AN-178825 - Medium
    Increased the size of the ENTRY_ID column so that there are no Quartz errors on startup when bringing up Appian in kubernetes.

  • AN-178893 - Medium
    Empty gray space no longer appears at the bottom of interfaces when collapsible or scrollable components contain content taller than the remaining page space underneath.

  • 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-179276 - Medium
    Fixed an issue that caused clicking the previous or next arrow in date/time components to incorrectly trigger links defined on their wrapping card layouts.

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

  • AN-179578 - Medium
    RPA specific variables now display correctly in Appian designers

  • AN-179634 - Medium
    Fixed an issue where record type security warnings were not reflected in the Health Dashboard security warnings count or the Inspect Package step of Compare and Deploy.

  • AN-175471 - Low
    Removed unnecessary error message about elasticsearch-keystore.

  • AN-175835 - Low
    Resolved some warnings and error messages on search server startup.

  • AN-177340 - Low
    Suppressed unnecessary Elasticsearch error messages from tomcat-stdOut.log.

  • AN-178793 - Low
    Fixed an issue where package inspection incorrectly flagged objects as having missing precedents if they reference a record field from a process-backed record type and the process variables in that process model were modified.

  • AN-178821 - Low
    Fixed an issue where PDF thumbnails can cause memory leaks.

  • Security Updates - Low

  • AN-175973 - Medium
    Fixed an issue where not all process properties were visible depending on the users configured language.

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

  • AN-178276 - Medium
    The details view of a deployment that contains either objects with the conflict detected status or objects with the same definition but with different version numbers across environments, now renders correctly.

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

  • AN-179118 - Medium
    Fixed an issue where 'Cancel' and 'Save And Close' buttons were misplaced in the Process Model Expression Editor.

  • AN-176640 - Low
    Fixed a display issue where the background content was not entirely grayed out when a record action dialog appeared.

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

  • AN-178817 - Low
    Improved exception logging

  • AN-179156 - Low
    Fixed an issue which prevented long expressions from being collapsible in the expression editor.

  • Security Updates - High

  • AN-176681 - Medium
    Fixed an issue that prevented document extraction from detecting some checkboxes in PDFs with fillable forms.

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

  • 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.

  • 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.

  • Security Updates - Medium

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

  • AN-174381 - Medium
    Fixed an issue where precedents of a record type were only identified after the record type was saved multiple times.

  • 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-178212 - Medium
    Navigating to record links referencing invalid page URLs will no longer cause errors in sites.

  • AN-177848 - Low
    Resolved a serialization error when modifying a grid.


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 21.1 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