Using CCleaner.INI to modify how CCleaner runs

Change how CCleaner runs with CCleaner.INI:

This page focuses on CCleaner INI files and how to use them to change how CCleaner runs. For a detailed look at INI settings and functions, view the table further below. 

Note: This page's contents targets advanced users of our app and may require a certain level of technical knowledge and expertise.

CCleaner stores its settings in the Windows Registry:

If you want to change CCleaner's settings using scripting, you can tell CCleaner to store them in ccleaner.ini in CCleaner's program folder.

You can also change how CCleaner stores its settings.

Different INI settings and how these function:




(App)Program Name

These entries indicate programs that are not part of the default set of enabled Cleaning Rules, and whether they should be cleaned.

Note: Making an entry of "App(Your Program)]=true" will not allow CCleaner to clean it, as you would instead need to use the methods listed here.

True - Checkbox selected when you start CCleaner.

False - Checkbox cleared when you start CCleaner.


This closes CCleaner after cleaning.

0 - Disabled.

1 - Enabled.


This is the default path for Issues Registry backup.



This prompts you to back up the contents of proposed Registry Issues before you remove them.

0 - Disabled.

1 - Enabled.


This is whether or not automatic browser cleaning is active (CCleaner Professional).

0 - Disabled.

1 - Enabled. 


This lists cookies you have chosen to keep.



This is a detailed view screen (for the whole analysis or cleaning) after the operation finishes.

0 = Disabled.

1 = Enabled.

IncludeX (e.g. Include1, Include2)

These are custom files or folders that you have specified you want cleaning.


ExcludeX (e.g. Exclude1, Exclude2)

These are custom files or folders that you want to exclude from all cleaning.


FinderIncludeX (e.g. FinderInclude1, FinderInclude2)

These are drives or folders CCleaner uses when searching for duplicate files.



This is whether the checkboxes have been checked or unchecked for folders referenced by FinderIncludeX above.

0 - Cleared

1 - Selected

For example, if there are three FinderIncludeX statements, you can specify the checked/cleared status using the pipe symbol:

FinderIncludeStates=1|0|1 would check the first and last items, and the middle one would be unchecked.


If enabled, CCleaner will only delete temporary Windows files older than 48 hours.

0 - Disabled.

1 - Enabled.


This is whether CCleaner starts on Health Check or Custom Clean

0 - Custom Clean

1 - Health Check


If enabled, CCleaner displays no warnings when you select advanced items in the cleaning options tree.

0 - Disabled.

1 - Enabled.


If enabled, CCleaner displays a detailed log of Internet Explorer temporary files.

0 - Disabled.

1 - Enabled.


If enabled, CCleaner displays a detailed log of Firefox/Mozilla temporary files.

0 - Disabled.

1 - Enabled.


This indicates which language file CCleaner should use when opening.

For a list of locale IDs, see this article. For a list of CCleaner's supported languages, see this topic.


If enabled, CCleaner will be minimized to the system tray when you click the Close button.

0 - Disabled.

1 - Enabled.


This is whether Smart Cleaning is enabled or not.

0 - Disabled

1 - Enabled


CCleaner asks you to confirm the Cleaning operation.

True - the checkbox is selected when CCleaner starts.

False - the checkbox is cleared when CCleaner starts.


When you choose to clean the Internet Cache in Mozilla Firefox, a warning message appears.

True - the checkbox is selected when CCleaner starts.

False - the checkbox is cleared when CCleaner starts.


When you select Internet Cache in Google Chrome to clean it, a warning message appears.

True - the checkbox is selected when CCleaner starts.

False - the checkbox is cleared when CCleaner starts.


No longer used by CCleaner, will automatically be set to 0 when you run it.



Whether or not System Smart Cleaning is active or Active Monitoring is active for the system (CCleaner Professional).

0 - Disabled.

1 - Enabled. 


If System Smart Cleaning system monitoring is active (see above), CCleaner uses the default action (CCleaner Professional).

3 - prompt to clean.

4 - auto clean with notification.

5 - auto clean without notification.


This means CCleaner checks for software updates every 10 minutes or when it starts.

0 - Disabled

1 - Enabled


If enabled, CCleaner uses a secure deletion method (see below).

0 - Disabled

1 - Enabled


If SecureDeleteType is set to 1, this setting determines which secure deletion method CCleaner uses.

0 - Simple Overwrite (1 pass)

1 - DOD 5220.22-M (3 passes)

2 - NSA (7 passes)

3 - Gutmann (35 passes)


The date and time CCleaner last checked for an update.

Do not modify.


These are settings representing CCleaner's window position.

Do not modify.


This is whether the Wipe Free Space setting wipes free space in the Master File Table.

0 - Disabled

1 - Enabled

Need to find your product license key?

Go to our license lookup page and enter your registered email address to retrieve info about your products, including product download links, license key(s), and expiry dates.

Send me my license details

Articles in this section