---
title: "Configuring POST Format"
canonical: https://www.aurigma.com/docs/us8/configuring-post-format.htm
product: "Upload Suite 8"
---

# Configuring POST Format
 
Let us assume the situation when you already have a Web site and want to embed ActiveX/Java Uploader in it. For example, your server-side scripts parse the POST request in a strongly defined format, and, of course, you do not want to rewrite them to make compatible with ActiveX/Java Uploader. In this case you just need to configure the control to send the POST request in the necessary format.

As you know, ActiveX/Java Uploader sends files and additional data as POST fields. There are two kinds of these fields:

- Standard fields contain all the files and other upload information generated by ActiveX/Java Uploader. Standard fields have a predefined format by default.
- Additional fields are custom. They can be attached to the POST request using the Metadata.AdditionalFormName[AdditionalFormName (ASP.NET)](https://www.aurigma.com/docs/us8/JA_P_Aurigma_ImageUploader_Metadata_AdditionalFormName.htm.md)[AdditionalFormName (PHP)](https://www.aurigma.com/docs/us8/JA_P_P_Metadata_AdditionalFormName.htm.md)[additionalFormName (JavaScript)](https://www.aurigma.com/docs/us8/JA_P_J_$au_metadata_additionalFormName.htm.md) property or the [metadata.addCustomField(String, String, Boolean)](https://www.aurigma.com/docs/us8/JA_M_J_$au_metadata_addCustomField_3_c43e5881.htm.md) method. Additional fields can use any format you like but should not conflict with the standard field names.

See the [POST Field Reference](https://www.aurigma.com/docs/us8/post-field-reference-iu.htm.md) topic for more details.

If a predefined format of standard POST fields is inconvenient for you, as in the situation described in the beginning of this article, you can rename them using the [renameStandardField(String, String)](https://www.aurigma.com/docs/us8/JA_M_J_$au_metadata_renameStandardField_2_393e8f3d.htm.md) method. This method uses two string parameters *originalName* and *newName*, where *originalName* is a name of some standard field and *newName* is its new name. Both parameters can contain particular indices or use the following placeholders:

- `[itemIndex]` is the current index of the uploaded file.
- `[converterIndex]` is the current index of the converted file.

The code sample below demonstrates how to rename standard POST fields and attach the additional fields to make ActiveX/Java Uploader compatible with server-side scripts which parse the POST request in the following format:

- **Author** means author of the uploaded file.
- **Number** means number of the uploaded file.
- **File*N*** is original file, where *N* is an index of this file.
- **File*N*-Description** is description of the *N*th uploaded file.
- **File*N*-Thumbnail*X*** is the *X*th thumbnail for the *N*th uploaded image, or icon for non-image files.
- **File*N*-Thumbnail*X*-Size** is size of the *X*th thumbnail of the *N*th uploaded image.
- **File*N*-Thumbnail*X*-Width** is width of the *X*th thumbnail of the *N*th uploaded image.
- **File*N*-Thumbnail*X*-Height** is height of the *X*th thumbnail of the *N*th uploaded image.

```
var u = $au.uploader({
    id: 'Uploader1',
    converters: [
        { mode: '*.*=SourceFile'},
        { mode: '*.*=Thumbnail;*.*=Icon', thumbnailFitMode: 'Fit', thumbnailWidth: '120', thumbnailHeight: '120' },
        { mode: '*.*=Thumbnail;*.*=Icon', thumbnailFitMode: 'Fit', thumbnailWidth: '640', thumbnailHeight: '480' }
    ],
    //... other parameters ...
});

u.metadata().addCustomField("Author", author);
u.metadata().renameStandardField("PackageFileCount", "Number");
u.metadata().renameStandardField("File0_[itemIndex]", "File[itemIndex]");
u.metadata().renameStandardField("Description_[itemIndex]", "File[itemIndex]-Description");
u.metadata().renameStandardField("File[converterIndex]_[itemIndex]", "File[itemIndex]-Thumbnail[converterIndex]");
u.metadata().renameStandardField("File[converterIndex]Size_[itemIndex]", "File[itemIndex]-Thumbnail[converterIndex]-Size");
u.metadata().renameStandardField("File[converterIndex]Width_[itemIndex]", "File[itemIndex]-Thumbnail[converterIndex]-Width");
u.metadata().renameStandardField("File[converterIndex]Height_[itemIndex]", "File[itemIndex]-Thumbnail[converterIndex]-Height");

u.writeHtml();
```
**Note** 
Renamed fields cannot be retrieved using the PostFields[PostFields (ASP.NET)](https://www.aurigma.com/docs/us8/JA_T_Aurigma_ImageUploader_PostFields.htm.md)[PostFields (PHP)](https://www.aurigma.com/docs/us8/JA_T_P_PostFields.htm.md) constants.
 
## See Also
 
### Reference
 
- Metadata Class[Metadata (ASP.NET)](https://www.aurigma.com/docs/us8/JA_T_Aurigma_ImageUploader_Metadata.htm.md)[Metadata (PHP)](https://www.aurigma.com/docs/us8/JA_T_P_Metadata.htm.md)[metadata (JavaScript)](https://www.aurigma.com/docs/us8/JA_T_J_$au_metadata.htm.md)
- [POST Field Reference](https://www.aurigma.com/docs/us8/post-field-reference-iu.htm.md)

### Manual
 
- [Uploading Additional Data in ActiveX/Java Uploader ASP.NET](https://www.aurigma.com/docs/us8/uploading-additional-data-in-aspnet-iu.htm.md)
- [Uploading Additional Data in ActiveX/Java Uploader PHP](https://www.aurigma.com/docs/us8/uploading-additional-data-in-php-iu.htm.md)