Contact Free trial Login

Global Settings Configuration

Global settings for a mule application such as the default transaction timeout or default error handler can be configured in the <configuration> element of the root level of the Mule Configuration File.
For example:

  <configuration defaultTransactionTimeout="31337" defaultErrorHandler="genericErrorHandler">


Specifies defaults and general settings for the Mule application instance.

Attributes of configuration

Name Description


The default period (ms) to wait for a synchronous response.
Type: string
Required: no
Default: 10000


The default timeout (ms) for transactions. This can also be configured on transactions, in which case the transaction configuration is used instead of this default.
Type: string
Required: no
Default: 30000


The default error handler for every flow. This must be a reference to a global error handler.
Type: string
Required: no
Default: none


(As of Mule 2.2.2) The time in milliseconds to wait for any in-progress messages to finish processing before Mule shuts down. After this threshold has been reached, Mule starts interrupting threads, and messages can be lost. If you have a very large number of services in the same Mule instance, if you have components that take more than a couple seconds to process, or if you are using large payloads and/or slower transports, you should increase this value to allow more time for graceful shutdown. The value you specify is applied to services and separately to dispatchers, so the default value of 5000 milliseconds specifies that Mule has ten seconds to process and dispatch messages gracefully after shutdown is initiated.
Type: integer
Required: no
Default: 5000


The approximated maximum space in megabytes used by the transaction log files for transactional persistent queues. Take into account that this number applies both to the set of transaction log files for XA and for local transactions. If both type of transactions are used then the approximated maximum space used will be twice the configured value. Type: integer Required: no
Default: 500


An optional reference to an ObjectSerializer to be used as the application’s default.
Type: string
Required: no
Default: none

Child Elements of <configuration…​>

Name Cardinality Description



The default expiration settings for dynamic configurations, used by connectors. This can also be configured on connectors, in which case the connector configuration is used instead of this default.



Configuration of Mule Expression Language (MEL).



Mule application cluster configuration.

Was this article helpful?

💙 Thanks for your feedback!

Edit on GitHub