# File import and export

To import metadata or screenshots, we offer various file templates.

**Hint: for the import to work, keep the file structure. Also, keywords such as country codes. The order of the languages can vary. Omit unnecessary languages or fields.**

### Available templates

Download all metadata and screenshot templates from the [File Templates](https://docs.appstoremanager.net/documents/import-and-export/file-templates) page.

See the [Screenshot and asset upload](https://docs.appstoremanager.net/documents/edit-translate-and-upload/screenshot-and-asset-upload) documentation for asset upload details.

### How to prepare the screenshot/ asset templates?

Download the required template from above. Unpack it to a location of your choice.

The unwrapped folder (referred as top-level folder) should look like this:

<figure><img src="https://3157999510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC766X4IlgRAg3uNFiRyW%2Fuploads%2F3bqokHKg4h86vqVoJKb6%2Fimage.png?alt=media&#x26;token=7a79b312-cad0-405a-a3a5-e58fac713640" alt=""><figcaption><p>Screenshot/ asset file template</p></figcaption></figure>

**Hint: the files vary between iOS and Android. Especially the subfolders are different**

Android:

<figure><img src="https://3157999510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC766X4IlgRAg3uNFiRyW%2Fuploads%2Fp849O4ure1s7u0LqWgUp%2Fimage.png?alt=media&#x26;token=f2d05ad0-5326-4de3-8420-8339686dd49a" alt=""><figcaption><p>Android subfolders which contain assets</p></figcaption></figure>

iOS:

<figure><img src="https://3157999510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC766X4IlgRAg3uNFiRyW%2Fuploads%2FUbTdNfA2pPlTQ7cOASFa%2Fimage.png?alt=media&#x26;token=76c461cb-6644-47a3-9902-0b3ce10264ad" alt=""><figcaption><p>iOS subfolders</p></figcaption></figure>

Add your screenshots to the corresponding language and resolution folders.

For example, if you want to upload English screenshots for the American market, add them to “en-US”. If you want to upload iPhone 6.5-inch screenshots only, add them to the “iphone-65” folder and leave the other folders empty.

For Android, place the mobile screenshots in the “mobile” folder.

Name your images from 1.png to 8.png (Android) or 1.png to 10.png (iOS).\
**Hint: Both JPG and PNG files are supported.**

<figure><img src="https://3157999510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC766X4IlgRAg3uNFiRyW%2Fuploads%2Fei7vXD2XMHDnhUN3qfYL%2Fimage.png?alt=media&#x26;token=334b6d1f-178f-4188-bb6d-ec872ed9ab65" alt=""><figcaption><p>Screenshot naming</p></figcaption></figure>

### Prepare the file for upload

To prepare the contents for the upload, create a ZIP (compressed)-archive. Navigate to the top level of your working folder. This is the level that displays the language folders. Select all of them and create a single compressed ZIP file.

<figure><img src="https://3157999510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC766X4IlgRAg3uNFiRyW%2Fuploads%2Fgit-blob-a46cfe7b9eed622f667d74b3a0ad5dce1b29c1b5%2Fscreenshot-top-level-working-folder.png?alt=media" alt=""><figcaption><p>Top-level working folder</p></figcaption></figure>

**Hint: The structure of the file must be correct. I.e., it happens that the parent folder is packed as well.**\
**Thus the upload will not work.**

Validate your archive file by opening it. It should direct display the language folders. If there is an enclosing folder within the archive, you likely have compressed the wrong structure.

<figure><img src="https://3157999510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC766X4IlgRAg3uNFiRyW%2Fuploads%2FXJM4DYadD3TenjtThuIC%2Fimage.png?alt=media&#x26;token=5ec03769-37ba-4117-bac5-f1b313774bf5" alt=""><figcaption><p>How a correct compressed file looks like (not all possible languages are shown above)</p></figcaption></figure>

A wrong and not supported structure of the compressed archive could look like this:

<figure><img src="https://3157999510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC766X4IlgRAg3uNFiRyW%2Fuploads%2FtGO1bCN1d7uaexq3gleL%2Fimage.png?alt=media&#x26;token=839ae4fa-4579-4a8d-aa2d-a88edbd12369" alt=""><figcaption><p>Unsupported structure</p></figcaption></figure>

**Hint: if you have any questions or require a different structure, please feel free to contact us.**
