Skip to content

lukylab/ios-permissions-descriptions

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 

Repository files navigation

iOS Permissions Descriptions

A collection of sample user-facing descriptions for permissions on iOS. As a developer, I often found myself rewriting permission strings and worrying if they were clear enough for users and App Store Review. This repo puts together concrete examples for all the common permissions, so you can ship faster and avoid confusion or rejections.


Why this exists

As an indie developer with more than 10 apps in the App Store, I know it’s easy to spend too much time thinking about how to word descriptions—or to forget some edge cases. App Review can be strict about vague or generic descriptions, and users appreciate clear, honest explanations too.

These samples come from my own apps and research. I’m sharing them here so other developers, especially those working solo or on small teams, can save time and avoid mistakes.


How to use this

  1. Browse the PERMISSIONS.md file to find the system permission you need.
  2. Copy and adapt a sample description for your own app and use-case.
  3. If you see anything missing, unclear, or that could be better, please open an issue or pull request—help the next developer, too.

Examples

Below are a few sample Info.plist entries for common iOS permissions.
For more, see the full PERMISSIONS.md file.

Camera

<key>NSCameraUsageDescription</key>
<string>Allows you to take photos for instant identification and saving to your profile.</string>

Location (When In Use)

<key>NSLocationWhenInUseUsageDescription</key>
<string>Your location is used to show trees and plants nearby on the map.</string>

Photo Library

<key>NSPhotoLibraryUsageDescription</key>
<string>Choose photos from your library for analysis and sharing in the app.</string>

Microphone

<key>NSMicrophoneUsageDescription</key>
<string>We need microphone access so you can record audio notes.</string>

For more permission keys and examples, check out PERMISSIONS.md.


Resources I keep handy


Check out my apps

If you’re curious what I’ve built, here are some of my apps:

If you want to follow my journey or grab your own “lucky app,” visit luckyapps.dev.


Contributing

This is a living resource—if you have ideas, better sample wordings, or new permissions, please open an issue or PR. The more we share, the more clarity and trust we give to users and reviewers alike.


License

Dedicated to the public domain. Licensed under CC0 1.0 Universal.


If you found this useful or have a question, you can reach me at luckyapps.dev or @lukassoukup.