---
title: "Restrictions.FileMask Property  HTML5/Flash Uploader PHP"
canonical: https://www.aurigma.com/docs/us8/FH_P_P_Restrictions_FileMask.htm
product: "Upload Suite 8"
---

# Restrictions.FileMask Property HTML5/Flash Uploader PHP

Supported technologies: ![Adobe Flash](https://www.aurigma.com/docs/us8/icons/flash.png)![HTML 5](https://www.aurigma.com/docs/us8/icons/html5.png)
 
Gets or sets a file mask for files allowed for upload.

## Syntax
 
```
public function getFileMask() {
}

public function setFileMask($value) {
}
```
 
### Property Value
 
Type: **string**
 
A file mask for files allowed for upload. The property value is a JSON string that contains array of filters. Each item consists of two elements:

- Description string displayed in the drop-down filter list in the open file dialog.
- List of file masks separated by semicolons. A file mask has the `*.<extension name>` format, where asterisk `*` is an arbitrary file name.

For instance, a filter can be set as follows: `[["Images", "*.jpg;*.png"], [...]]`, where `"Images"` is a description, and `"*.jpg;*.png"` is a file mask.
 
Even if a user chooses files that do not meet **FIleMask**'s requirements, Uploader sorts out the chosen files before adding them to the Upload Pane.
 
**Note** 
In Flash Uploader a file mask with a long description can work incorrectly due to Firefox limitations. Thus, we recommend setting description as short as possible. For example, `["Documents", "*.txt;*.rtf;*.pdf;*.doc;*.docx;*.xls;*.xlsx"]` works correctly but `["Documents (*.txt;*.rtf;*.pdf;*.doc;*.docx;*.xls;*.xlsx)", "*.txt;*.rtf;*.pdf;*.doc;*.docx;*.xls;*.xlsx"]` does not.
 
**Note** 
Due to browsers limitations, HTML5 Uploader ignores filter descriptions specified in settings and displays text strings predefined in a web browser. Even though descriptions are ignored, they are still required in parameters since Flash Uploader, which can be launched as a fallback option, supports them.
 
**Note** 
Due to Firefox security features, HTML5 Uploader always adds `*.*` mask to the file filter in this browser and makes it selected by default.
 
Instead of specifying a double array, you can just set a string with the single mask. However it will be incompatible with Flash uploader.
 
Default value is **"[]"**.

## Remarks
 
When opening a File Open Dialog in HTML5, it is necessary to specify a filter as a set of MIME types rather than file masks. HTML5 Uploader converts most popular file masks to appropriate file types automatically, but some exotic file extensions are not supported. In this case, you can configure a mapping between a file mask and MIME type manually, using **Aurigma.MimeMapping** collection, as follows:
 
**Aurigma.MimeMapping["\*.smth"] = "application/vnd.aurigma-stuff";**
 
Note, you should call this code before the uploader is initialized, for example, in the **InitComplete** event.

## See Also
 
### Reference
 
- [DeniedFileMask Property](https://www.aurigma.com/docs/us8/FH_P_P_Restrictions_DeniedFileMask.htm.md)
- [Aurigma.ImageUploaderFlash.Restrictions.FileMask ASP.NET Property HTML5/Flash Uploader](https://www.aurigma.com/docs/us8/FH_P_Aurigma_ImageUploaderFlash_Restrictions_FileMask.htm.md)
- [$au.restrictions.fileMask JavaScript Property HTML5/Flash Uploader](https://www.aurigma.com/docs/us8/FH_P_J_$au_restrictions_fileMask.htm.md)

### Manual
 
- [Configuring Restriction Rules for Files](https://www.aurigma.com/docs/us8/configuring-restrictions-and-file-filters-iuf.htm.md)