The following hotfix is available for Appian 22.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 22.1 installations not currently up to date with the latest hotfixes. After installing, you will be running on Appian 22.1.525.0.

22.1.525.0 Hotfix

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

If you are managing Appian on Kubernetes, instead of using the link above, you'll need to upgrade to the latest Appian images to apply the Hotfixes. You can do so by following the instructions on Upgrading Appian on Kubernetes.

Resolved issues


  • Security Updates - Critical

  • AN-205738 - High
    Sites using Appian-hosted MySQL database are upgraded to release 5.7.38, which includes security and bug fixes. Details are available on the MySQL website (

  • AN-207457 - High
    Skips populating the importance score for problematic records so that the app server is not halted on startup

  • AN-204464 - Medium
    Fixed an issue that caused an unexpected dirty flag to appear in the start form of certain process models when selecting the "Skip to main content" link in the URL bar from the start form.

  • AN-203594 - Low
    Improvements to reduce installation time of phpmyadmin.

  • AN-204739 - Low
    The performance of casts with record data types that occur automatically (such as passing a custom data type to a record data type rule input or vice versa) has been improved.


  • Security Updates - High

  • AN-206501 - High
    Fixed an issue where a single Kafka broker could lead to an outage until all the Kafka brokers are online.

  • AN-204239 - Medium
    Made improvements to reduce the likelihood of timeouts when loading the Rule Performance view.

  • AN-204718 - Medium
    Fixed an issue where occasionally syncs failed with the incorrect cause listed as a missing authentication token.

  • AN-206663 - Low
    Fixed issue where "Expected dialog to exist for id" error displayed in the compare and deploy wizard when one of the scripts is modified while viewing the compare and deploy script list.

  • AN-207045 - Low
    Fixed an issue that caused a!isUserMemberOfGroup to return an error when executed on an inactive user.


  • Security Updates - High

  • AN-195551 - High
    All MariaDB instances in Appian Cloud have been upgraded from version 10.5.15 to 10.6.7 for all Appian versions from 20.3 through 22.3. The upgrade includes the following MariaDB patches:- 10.6.0- 10.6.1- 10.6.2- 10.6.3- 10.6.4- 10.6.5- 10.6.6- 10.6.7Details about the content of each of these patches are available on the MariaDB Release Notes page:

  • AN-206166 - High
    Process variables of type CDTs can now be partially updated successfully. Prior to this fix, updating select fields of the variables would cause the remaining fields to be null.

  • AN-205235 - Medium
    Fixed an issue where modifying a CDT in a package removed the CDT from the package.

  • AN-206219 - Medium
    Fixed an issue on FedRAMP cloud sites that allowed the enable_native_doc_service custom property to be set to true using an import customization file.


  • Security Updates - High

  • AN-206020 - High
    Fixed issue where a system error was displayed when selecting a table during configuration of a synced record type. This error occurred when the data source had multiple database tables with the same name in different schemas.

  • AN-199194 - Medium
    Fixed an issue where the visibility of a record action used in a record grid column did not re-evaluate after the data was updated through a record action.

  • AN-202258 - Medium
    The function a!verifyRecaptcha() no longer returns an error when used multiple times in a portal.

  • AN-190652 - Low
    Removal of Appian Configuration JMX object.

  • AN-191817 - Low
    The elastic search property "index.max_terms_count" is now persisted to maintain custom configuration during site restart.


  • Security Updates - High

  • AN-206531 - High
    Customer will be provided the fix during a hotfix cycle

  • AN-205028 - Medium
    Fixed an issue where charts were refreshing unexpectedly when the chart contained links and filters on at least one measure.

  • AN-205554 - Medium
    Disabled Impact Analysis for the Record Importance Score Migration to avoid delays in webapp startup


  • Security Updates - High

  • AN-200822 - Critical
    Fixed an issue that prevented self-managed customers from specifying a non-default location for process notes.

  • AN-205342 - Critical
    Customers using a database other than MariaDB on versions 21.3 and below will now be able to successfully upgrade to 21.4 and above. This fix also fixed an issue in which synced records could no longer be synced successfully on databases other than MariaDB.

  • AN-202632 - High
    Fixed an issue that prevented certain functions from being properly evaluated when used as an input parameter in a process model.

  • AN-205026 - High
    Fixed an issue where import failed for record types that were created prior to 20.1, had related actions, and had not been updated using the method for updating legacy record types (see the 'Update a Legacy Record Type' documentation page for details).

  • AN-203617 - Medium
    Log files downloaded from the Portals publishing manager now correctly include logs up to the time when the download button is clicked.

  • AN-204251 - Medium
    Fixed issue with ZooKeeper writing to its log directory when upgraded to version 3.8.0.

  • AN-204276 - Medium
    Fixed an issue that caused identical random values to be generated by the rand() function when used in unique parallel process executions.

  • AN-204431 - Medium
    Fixed an issue affecting sort behavior when null values are present in the data set.

  • AN-204952 - Medium
    Fixes a bug that addresses bindings of system rule wrappers

  • AN-205004 - Medium
    Fixed an issue affecting sort behavior when null values are present in the data set.

  • AN-205231 - Medium
    Fixed an issue that prevented user from switching between published and draft versions of Data Store Object in Appian Designer.

  • AN-200469 - Low
    Service Manager will automatically restart after an unexpected outage.

  • AN-204997 - Low
    Fixed an issue that duplicated lines in an import customization file (ICF) when a user added contents from one package to another. This issue took place if a source package contained a database script and an import customization file.

  • AN-205123 - Low
    Resolved an issue with routing http traffic.


  • Security Updates - High

  • AN-200096 - High
    Process deletion is now optimized to consume less memory.

  • AN-203591 - High
    Resolved an issue when changing usernames.

  • AN-200935 - Medium
    Fixed an issue with the breadcrumbs on the precedents and dependents views, where clicking All Application Objects did not return you to the correct starting point.

  • AN-201638 - Medium
    The Rename User Smart Service now successfully prevents you from renaming an invalid user with null username. Prior to this fix, overwriting such a user would cause process variables of type 'User' to be automatically assigned an incorrect default value even though there is no default value configured for the variable.

  • AN-202158 - Medium
    Fixed an issue that prevented some task viewers to be able to successfully open links in the task interface when they had not accepted the task.

  • AN-202500 - Medium
    Fixed an issue that caused Health Check Data Collection to fail due to the presence of tar.gz files.

  • AN-202514 - Medium
    Added log messages for the creation of certificates for connected environments and OAuth tokens to provide the full lifecycle of these certificates.

  • AN-202926 - Medium
    Fixed issue where a record type incorrectly showed fields from multiple tables if the only difference in table names is that one table name used either the "%" or the "_" wildcard characters. For example: "abc_table" and "abcdtable", "abc%j and "abcdefgj.

  • AN-202989 - Medium
    Fixed an issue in Generate Record Action where users could attempt to generate an action with a data store in an unverified state, resulting in an error.

  • AN-204219 - Medium
    Fixed an issue where the link to the post-deployment process results did not show in the summary view of a deployment.

  • AN-204344 - Medium
    The a!queryRecordType() function now evaluates in parallel.

  • AN-201723 - Low
    Fixed an issue in Generate Record Action where configuring a data store could result in an error.

  • AN-202310 - Low
    Upgraded phpMyAdmin to 5.1.3

  • AN-203091 - Low
    Fixed the status scripts reporting of topic replication lag in instances where MirrorMaker was inactive or failed to start.


  • Security Updates - Critical

  • AN-200267 - High
    Fixed an issue during site shutdown that could result in incomplete engine checkpoints.

  • AN-202627 - High
    Group properties can now be updated successfully without any errors. Prior to this fix, updating group properties would fail due to a rollback on the personalization engine.

  • AN-202684 - High
    Querying process history now consumes less memory especially for long running process instances.

  • AN-203053 - High
    Fixed an issue that caused performance degradation when a user belonging to a high number SAML groups logs in to Appian.

  • AN-203143 - High
    Process history is now displayed correctly in the Process Modeler. Prior to this fix, incomplete process history would be displayed in the modeler while monitoring a process.

  • AN-123425 - Medium
    For Appian Cloud customers, the sail_state_cache table in Appian data source is now truncated during site startup to preserve disk space.

  • AN-190032 - Medium
    Fixed an issue that caused some documents to be rendered as blank when used in the Reconcile Doc Extraction smart service.

  • AN-199064 - Medium
    Fixed an issue that caused an unexpected "Does not exist: Expression" while a certain process is being executed. Prior to this fix, an internal race condition caused the process to complete before it's associated expression has been completed evaluated, resulting in the error.

  • AN-200300 - Medium
    Appian Cloud database has been upgraded to MariaDB 10.5.15.

  • AN-200374 - Medium
    Fixed an issue with exporting a Read-Only Grid in cases where an included Link Component is missing a valid link.

  • AN-201868 - Medium
    System logs for portals can now be downloaded from the portal details page in the Publishing Manager application. New options allow filtering the requested logs by recency.

  • AN-201984 - Medium
    Fixed an issue that caused process variables of type 'User' to be automatically assigned an incorrect default value even though there is no default value configured for the variable.

  • AN-202307 - Medium
    Fixed an issue which displayed an error when using a!gridField with data passed from a parent interface.

  • AN-203263 - Medium
    Fixed an issue that prevented process metrics functions from appearing in the suggested functions menu of the expression editor when opened using the Process Instances dialog.

  • AN-186797 - Low
    The max_active property for both the Appian and AppianAnywhere data sources is now configurable with default value of 100.

  • AN-200273 - Low
    Fixed an issue in determining Kafka replication factors that could lead to HA failure during periods of Kafka instability.

  • AN-201791 - Low
    The MirrorMaker startup script has been updated to include additional logging and health checks for Kafka.

  • AN-202673 - Low
    Fixed an issue where opening a dialog from a Header Content Layout with a custom background color reset the page's background to white

  • AN-202936 - Low
    Security Improvement

  • Security Updates - Critical

  • AN-198855 - High
    Fixed an issue in an internal migration of process history which caused the process execution engine to rollback due to an incorrect and unexpected null value.

  • AN-201743 - High
    Fixed an issue that contributed to browser slowness when opening Decision Designer containing large numbers of cells.

  • AN-202033 - High
    Process executions no longer fail due to unexpected process errors. This fixes an issue caused by AN-196802 where a process would be unexpectedly paused by exception when running on an engine it wasn't published on.

  • AN-202169 - High
    Fixed an issue where an error message displayed when a!queryRecordType() was used within one of the following looping functions: all, any, apply, filter, merge, none, reduce, or reject.

  • AN-202296 - High
    Updated the image.

  • AN-199489 - Medium
    The performance of casting from a list of custom data types to record data types has been improved.

  • AN-201508 - Medium
    Basic users in the Portal Publishers group are now correctly able to select a service account when publishing a portal.

  • AN-201588 - Medium
    Fixed an issue which prevented some users from being able to publish a Portal.

  • AN-201976 - Medium
    Fixed an issue where record action components in a menu layout were incorrectly refreshing.

  • AN-201982 - Medium
    Portals will now respect environment-specific constant values provided via the Application Properties Data field at the time of publishing.

  • AN-202022 - Medium
    Fixed an issue with drag and drop. Hovering over a column while dragging a column no longer throws a Javascript error.

  • AN-198376 - Low
    Fixed an issue which, in rare scenarios after an upgrade, caused an error upon editing a record list interface or viewing record list performance in the Appian Designer.

  • AN-201263 - Low
    Data sources created in the admin console and connected systems now have a default validation query timeout of 5 seconds.

  • Security Updates - Low

  • AN-201182 - Critical
    Fixed an issue where applications with a large number of objects in them caused performance issues.

  • AN-199186 - High
    Redis deployment upgrade.

  • AN-200881 - High
    Fixed an issue where an error message displayed when a!queryRecordType() was used within one of the following looping functions: all, any, apply, filter, merge, none, reduce, or reject.

  • AN-201645 - High
    Fixed an issue that prevented site shutdown when encountering an engine responsiveness service failure.

  • AN-198343 - Medium
    Fixed an issue where user filters configured via a local variable were not persisting as expected.

  • AN-199887 - Low
    Fixed a memory management issue that may lead to unresponsive sites and full site outages.

  • Security Updates - Critical

  • AN-201190 - Critical
    Updated Debian-CIS baseline image to address Kafka container vulnerabilities.

  • AN-201191 - Critical
    Updated Debian-CIS baseline image to address Service Manager container vulnerabilities.

  • AN-201193 - Critical
    Updated Debian-CIS baseline image to address ZooKeeper container vulnerabilities.

  • AN-196598 - High
    Queries are now correctly refreshing after completion of a record action. This updates behavior to be consistent with Appian 21.3 and earlier.

  • AN-200147 - High
    Contextual related action modals now close only once the parent UI has finished evaluating.

  • AN-200219 - High
    Fixed an issue to prevent inappropriate values from being stored for process history location.

  • AN-200233 - High
    Fixed an issue that caused the isusermemberofgroup() function to throw an expression evaluation error for some customers after upgrading to Appian 21.3.

  • AN-200543 - High
    Fixed an issue that could result in Appian Data Service not being available in case of a disk failure.

  • AN-200841 - High
    Indirect members are now displayed correctly while viewing the list of members of a group in Appian Designer.

  • AN-200966 - High
    Fixed an issue that slowed imports of large applications.

  • AN-198908 - Medium
    Enhanced the process model history API to allow filtering by process id for process mining.

  • AN-200034 - Medium
    The load performance of complex record list and record view expressions has been improved.

  • AN-200038 - Medium
    Fixed an issue in document extraction that occasionally caused fields in fillable PDFs to be extracted to the incorrect fields in the Appian data type.

  • AN-200049 - Medium
    Searching for Appian documents and folders using IDs or UUIDs is now faster and more efficient. Prior to this fix, searching for these objects could cause high load on the content engines resulting in slowness across the environment.

  • AN-200145 - Medium
    Data is now correctly refreshed immediately after the completion of a formless record action.

  • AN-200261 - Medium
    Improved performance of user and group picker suggestions when a group filter is supplied.

  • AN-200851 - Medium
    Custom data type field names are now visible in expression autosuggest for variables and rule inputs with long names.

  • AN-200969 - Medium
    Fixed an issue with the Service Manager startup sequence that could result in silent startup failures.

  • AN-201123 - Medium
    Resolved an issue that caused Task Report query results to be different from the Task Report object when paging info is defined.

  • AN-201180 - Medium
    Fixed an issue that caused that caused performance degradation with the Email Poller when using IMAPS protocol.

  • AN-201252 - Medium
    Fixed an issue that caused an error to appear when a user viewed a record view from the User record type that had not been updated.

  • AN-201308 - Medium
    Security Improvement

  • AN-201429 - Medium
    Add the CollaborationDocument template to the mobile bootstrap.This resolves a bug where Dynamic Offline attachments wouldnot be cached on signin due to the clients not having thisuri template.

  • AN-199852 - Low
    Fixed a typo in the Query Editor Sorting and Limiting Data section.

  • AN-200131 - Low
    Enhanced the process history APIs to improve mining of process data in Appian.

  • Security Updates - Critical

  • AN-198124 - Critical
    Fixed an issue that could result in a long-running or failed upgrade for some customers.

  • AN-198249 - Critical
    Fixed an issue that prevented process instances from starting after upgrade for some self-managed customers.

  • AN-198588 - Critical
    Fixed an issue that could result in a long-running or failed upgrade for some customers.

  • AN-199620 - Critical
    Fixed an issue that resulted in browser slowness when rendering Editable Grid Components containing very large numbers of cells. This fix also addresses the UI slowness observed in Decision Designer, since it relies on the Editable Grid Component.

  • AN-197578 - High
    Starting a process using the Start Process Smart Service no longer causes high java queue utilization. Prior to this fix, using the smart service to start a process on Appian 21.4 would cause work items to be stuck on the java queue causing the site to be unusable in some cases.

  • AN-198268 - High
    Fixed an issue that prevented some customers from being able to connect the Mail Poller to POP3 email servers when using TLS 1.2.

  • AN-199158 - High
    Added an optimization to process model validation that speeds up previously slow deployments for certain process models.

  • AN-199704 - High
    Fixed an issue where some Appian customers were experiencing increased memory usage as a result of recent optimization efforts.

  • AN-196308 - Medium
    Fixed an issue that prevented export record grid to Excel from working when the record list was used in a site.

  • AN-197367 - Medium
    Fixed an issue where system administrator accounts did not see the correct security groups pre-populated in the object list for Generate Record Actions.

  • AN-197548 - Medium
    Fixed an issue that prevented the application server from starting due to NULL usernames being added to the database.

  • AN-197919 - Medium
    Fixed an issue with Read-Only Grids sourced from records data that resulted in an error when Disable Row Selection parameter is enabled and the result set is empty.

  • AN-198140 - Medium
    Fixed a padding issue that affected Quick Task objects

  • AN-198208 - Medium
    Fixed an issue that caused some customers to experience occasional failures when using the SAP Connector plugin.

  • AN-198386 - Medium
    Fixed an issue that caused an error when displaying lists whose type can change

  • AN-198505 - Medium
    Fixed an edge case scenario that resulted in some queried values from ADS being incorrectly returned as all lowercase.

  • AN-187001 - Low
    Interface previews in Appian Designer are now wider to reduce wrapping of contents.

  • AN-194813 - Low
    Fixed an issue where Application Prefixes would not auto-populate on Integration objects when the Integration was created during the creation of a Connected System.

  • AN-195192 - Low
    Fixed an issue that caused 'DML- MISSING' errors to be displayed in the log files when a user is created on the site.

  • AN-198095 - Low
    Fixed an edge case scenario that resulted in some queries from ADS being sorted by case-folded values rather than the stored values.

  • AN-198564 - Low
    About Appian modal no longer errors out when RPA is not enabled on the site

  • AN-198593 - Low
    Record syncs now have the correct timeout limit on import. This updates behavior to be consistent with Appian 21.2 and earlier.


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 22.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 Built: Sat, Jul 02, 2022 (01:44:10 AM)

On This Page