check_app_store_metadata¶

Check your app's metadata before you submit your app to review (via precheck)

Precheck¶

Check your app using a community driven set of App Store review rules to avoid being rejected¶

Apple rejects builds for many avoidable metadata issues like including swear words 😮, other companies’ trademarks, or even mentioning an iOS bug 🐛. fastlane precheck takes a lot of the guess work out by scanning your app’s details in App Store Connect for avoidable problems. fastlane precheck helps you get your app through app review without rejections so you can ship faster 🚀

Features • Usage • Example • How does it work?

Features¶

	precheck Features
🐛	 product bug mentions
🙅	Swear word checker
🤖	Mentioning other platforms
😵	URL reachability checker
📝	Placeholder/test words/mentioning future features
📅	Copyright date checking
🙈	Customizable word list checking
📢	You can decide if you want to warn about potential problems and continue or have fastlane show an error and stop after all scans are done

Usage¶

Run fastlane precheck to check the app metadata from App Store Connect

fastlane precheck

To get a list of available options run

fastlane action precheck

Example¶

Since you might want to manually trigger precheck but don't want to specify all the parameters every time, you can store your defaults in a so called Precheckfile.

Run fastlane precheck init to create a new configuration file. Example:

# indicates that your metadata will not be checked by this rule
negative_apple_sentiment(level: :skip)

# when triggered, this rule will warn you of a potential problem
curse_words(level: :warn)

# show error and prevent any further commands from running after fastlane precheck finishes
unreachable_urls(level: :error)

# pass in whatever words you want to check for
custom_text(data: ["chrome", "webos"], 
           level: :warn)

Use with fastlane¶

precheck is fully integrated with deliver another fastlane tool.

Update your Fastfile to contain the following code:

lane :production do
  # ...

  # by default deliver will call precheck and warn you of any problems
  # if you want precheck to halt submitting to app review, you can pass
  # precheck_default_rule_level: :error
  deliver(precheck_default_rule_level: :error)

  # ...
end

# or if you prefer, you can run precheck alone
lane :check_metadata do
  precheck
end

How does it work?¶

precheck will access App Store Connect to download your app's metadata. It uses spaceship to communicate with Apple's web services.

Want to improve precheck's rules?¶

Please submit an issue on GitHub and provide information about your App Store rejection! Make sure you scrub out any personally identifiable information since this will be public.

check_app_store_metadata
Supported platforms	ios
Author	@taquitos
Returns	true if precheck passes, else, false

2 Examples¶

check_app_store_metadata(
  negative_apple_sentiment: [level: :skip], # Set to skip to not run the `negative_apple_sentiment` rule
  curse_words: [level: :warn] # Set to warn to only warn on curse word check failures
)

precheck   # alias for "check_app_store_metadata"

Parameters¶

Key	Description	Default
`app_identifier`	The bundle identifier of your app	*
`username`	Your Apple ID Username	*
`team_id`	The ID of your App Store Connect team if you're in multiple teams	*
`team_name`	The name of your App Store Connect team if you're in multiple teams	*
`default_rule_level`	The default rule level unless otherwise configured	`:error`
`include_in_app_purchases`	Should check in-app purchases?	`true`
`negative_apple_sentiment`	mentioning  in a way that could be considered negative
`placeholder_text`	using placeholder text (e.g.:"lorem ipsum", "text here", etc...)
`other_platforms`	mentioning other platforms, like Android or Blackberry
`future_functionality`	mentioning features or content that is not currently available in your app
`test_words`	using text indicating this release is a test
`curse_words`	including words that might be considered objectionable
`free_stuff_in_iap`	using text indicating that your IAP is free
`custom_text`	mentioning any of the user-specified words passed to custom_text(data: [words])
`copyright_date`	using a copyright date that is any different from this current year, or missing a date
`unreachable_urls`	unreachable URLs in app metadata

* = default value is dependent on the user's system

To show the documentation in your terminal, run

fastlane action check_app_store_metadata

View source code

Back to actions