Skip Navigation

Search

File Extension Type restrictions for uploading files in Chat
Answer ID 12603   |   Last Review Date 08/18/2026

How do you restrict file extension types when customers upload a file in chat?

Environment: 

Chat, File attachments

Resolution:

Administrators can configure the list of file extensions accepted during chat by modifying configuration setting VALID_FILE_EXTENSIONS. More details can be found in our Online documentation at this link: Configure File Types.

Please note that this configuration setting will affect all Chat widgets, as well as Incidents. See also: File Extension Type restrictions when creating incident from Ask a Question page

Depending on the type of chat implementation, there may be additional settings that would need to be taken into account. Please expand the relevant section for your Chat implementation below for more details. 

For Customer Portal versions 3.9 and later

Customer Portal versions 3.9 and greater use the CP.ValidFileExtensions and CP.ValidFileMimeTypes values set in siteConfig.json, which can be found under /cp/customer/development/config/

You will need to make sure that any changes you make to the siteConfig.json matches the config verb. If not, then the restrictions will not work.
 
To access your Customer Portal, you’ll also need a WebDAV client for downloading and uploading files. Please see Answer 2600: Configuring WebDAV connection to access the Customer Portal or Answer 4704: Popular Answers About WebDAV for more information about using WebDAV. 
 

For Customer Portal versions 3.8 and lower

In Customer Portal (CP) versions 3.8 and lower there is a 'valid_file_extensions' attribute in the ChatAttachFileButton widget where you can define a list of accepted file extensions without leading periods and separated by commas. 

Please note, the 'valid_file_extensions' default for the attribute is defined by all extensions.

You can edit this widget by going to the path below:

Customer Portal v3.x (3.8 and lower):

standard/chat/ChatAttachFileButton

Example:
<rn:widget path="chat/ChatAttachFileButton" valid_file_extensions="gif,pdf,doc" />

 
You will need to make sure that any changes you make to the valid_file_extensions widget matches the config verb. If not, then the restrictions will not work.
 
To access your Customer Portal, you’ll also need a WebDAV client for downloading and uploading files. Please see Answer 2600: Configuring WebDAV connection to access the Customer Portal or Answer 4704: Popular Answers About WebDAV for more information about using WebDAV. 
 
The widget can be found in file: cp/customer/development/views/pages/chat/chat_landing
 

For Chat Inlays

Chat Inlays also use the file-upload-valid-types attribute on the chat-embedded inlay. See Inlay Registry > Inlays > inlay-oracle-chat-embedded > Attributes > file-upload-valid-types.

e.g.

<inlay-oracle-chat-embedded
 id="chatInlay"
 file-upload-enabled="true"
 file-upload-valid-types='["image/*",".doc"]'
 ...

The default value is:

file-upload-valid-types='[".bmp",".doc",".docx",".gif",".jpeg",".jpg",".pdf",".png",".xls",".xlsx"]'

This list should be customized to match how you configured the VALID_FILE_EXTENSIONS config as well.

For Web Chat for Service (WCFS)

To manage file sharing in WCFS, use Functionality Configuration > Attachment Settings in EE Web Chat component settings to:

  • set file upload and download settings 
  • set supported file type - this list should be customized to match how you configured the VALID_FILE_EXTENSIONS config as well.