> For the complete documentation index, see [llms.txt](https://docs.acrcloud.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.acrcloud.com/reference/console-api/bm-projects/metadata/custom-files.md).

# Custom Files

### JSON structure

```bash
{
    "custom_files": [
        {
            "bucket_id": "51",
            "title": "You are beautiful",
            "artist": "James",
            "acrid": "5343bc191634b042622bf474ed46121a",
            "audio_id": "3"
        }
    ]
}
```

### Metadata fields

| Name                              | Description                                                                           |
| --------------------------------- | ------------------------------------------------------------------------------------- |
| custom\_files                     | Custom uploaded file fields                                                           |
| arcid                             | ACRCloud unique identifier                                                            |
| title                             | File name                                                                             |
| audio\_id                         | User defined identifier                                                               |
| play\_offset\_ms                  | Position of the recognition in the file if the file was playing (millisecond)         |
| \*db\_begin\_time\_offset\_ms     | Position of beginning of the recognition on database file (millisecond)               |
| \*db\_end\_time\_offset\_ms       | Position of end of the recognition on database file (millisecond)                     |
| \*sample\_begin\_time\_offset\_ms | Position of beginning of the recognition in sample file sent by SDK/API (millisecond) |
| \*sample\_end\_time\_offset\_ms   | Position of end of the recognition in sample file sent by SDK/API (millisecond)       |

{% hint style="info" %}
***\* fields are visible in Broadcast Monitoring service only, if you want to use these fields in recognition service, please contact us.***

**Please note: Only *****Title, ARCID, Audio\_ID***** are required fields.**
{% endhint %}