- a site about all things Ionic

« Ionic + Fastlane

    First published: August 2017

Add metadata and upload to stores

You currently have lots of empty files in your fastlane/metadata folder from when you created the local metadata file structure (after you previously installed and initialized fastlane and created your apps in the stores).

Now you have to do some manual work and fill these files with real data.


Add metadata to files

Go through the fastlane/metadata folder and add your own metadata:

If you want your app to contain localized app information for additional languages, just create a copy of the en-US folder and rename it to the respective language code (e.g. de-DE for German).

When you are done you can run fastlane deliver to generate a html file as overview of the data:

`fastlane deliver` html preview

Upload to iTunes Connect

If you press n it won’t continue with the upload and you can fix things further.
If you are ready, press y to upload the data:

`fastlane deliver` upload success

Check iTunes Connect for success:

`fastlane deliver` metadata in iTunes Connect

Optional: Advanced language structure

If you want to to use the same strings in several languages and only differentiate some special languages you can also use the default language to avoid duplicating the string to all languages: Create the common string in a default folder, and the special version for example only in the de-DE folder that should be different from all the other languages that don’t include the string at all.


Add metadata to files

Of course you also have to do the same for the Android metadata in fastlane/metadata/android:

  • metadata/android/en-US/full_description.txt contains your full app description.
  • metadata/android/en-US/short_description.txt should also describe your app but is limited to 80 characters and is “the first text users see when looking at your app’s detail page on the Play Store app.”
  • metadata/android/en-US/title.txt should already be prefilled with your initial app name
  • metadata/android/en-US/video.txt can be a YouTube URL of a video that previews your app and will be shown in the Play Store

Additionally to the files that get created by default you also should create these required graphic files:

  • metadata/android/en-US/images/featureGraphic.png is a promotional banner that can be shown in the Play Store to advertise your app (Size: 1024x500px)
  • metadata/android/en-US/images/icon.png is the app icon shown in the Play Store (Size: 512x512px)

All files are localized, and identical to iOS you can create additional languages by duplicating the en-US folder and giving it the intended countries’ language code as new name.

There is no “generate preview” functionality in supply yet unfortunately, so check your files twice to make sure you didn’t miss anything.

Upload to Google Play Console

Execute fastlane supply to upload the data to Google Play Console:

`fastlane supply` upload success

Check the Play Console for confirmation it worked:

`fastlane supply` metadata in Play Console

Note that supply doesn’t yet support all fields that the Google Play console requires, e.g. “category” is not downloaded and can not be set for Android apps. You have to do that manually before publishing your app later.

Note that both tools don’t update the default language of your app or remove translations that are not part of your file structure. You will have to do that manually for both the Play Store and the App Store.


With your apps created in the stores and them being filled with metadata, you “only” have to build your app for testing and later release.

« Ionic + Fastlane

    First published: August 2017