Editing User Permission (Permission Text) Messages

7/10/26

If your Kuika-developed app includes functionalities such as Camera usage, Location/Geolocation access and Notification sending, you will need to obtain user permission to access these functionalities. For each permission, it is important that you clearly indicate to users why these accesses are needed, how they will be used, and what impact these permissions may have on users' privacy. You need to add these permission descriptions in detail in the Permission Labels section of your application's configuration settings.

You can follow the steps below to create permission texts correctly:

Step 1: Navigate to Permission Labels

You can edit these permissions in your application's configuration settings under Permission Labels. This section is used to manage the messages required to request permission to the user. Permission descriptions should be entered according to the respective platform (Web, iOS or Android).

For Web: Click the drop-down menu opposite the Permission Labels heading on the configuration screen.
For iOS and Android: Similarly, on the configuration screen of the relevant platform, scroll down to the Permission Labels heading.

Step 2: Adding a New Permission

After logging in to the Kuika platform, open the project you will work on from the “Apps” screen.

Then click on the “Configuration Manager” module.
Give a name (1) to the configuration from the screen that opens and click on the “CREATE” (2) button.

Start adding a new permission description by clicking ADD NEW in the Permission Labels menu.

A new modal screen will open. Here you will be asked to enter the title and content information for each permission.
- Permission Title: Clearly specify the name of the permitted function (for example: Camera, Location, Notifications).
- Permission Content: Clearly explain to users for what purpose and under what conditions the permission is being granted. For example:
  - Camera: “This app will use your device's cameras to take photos or videos.”‍
  - Location: “The app will use your device's location information to provide map features and location-based services.”‍
  - Notifications: “This app will send important updates and notifications.”

Step 3: Languages Supported by the App

Before entering permission descriptions, a list of supported languages will open in your application. It is important to provide user-friendly descriptions in each language so that each user can understand the permission correctly.

Language Selection: For each language you support in your app, type the corresponding permission content. For example, if your app supports Turkish, English and German, you will need to enter different content for each language.

Step 4: Create Permission Content

After entering the permission descriptions for all languages, create the permission by clicking the CREATE button. This will create the permission text that will be shown to users.

In mobile apps developed with Kuika, you must obtain user permission to use device features such as location, camera, or Bluetooth. The text displayed to the user when permission is requested must clearly state why access is required and how it will be used. You can define these texts separately for each device feature through the Kuika Config Manager module.

In this guide, you’ll learn step-by-step how to create permission texts and add them to your app, using the GPS Tracker feature as an example.

How to Edit Permission Texts?

1. Open or Create a Configuration

Log in to the Kuika platform.
From the Apps screen, open the project you’ll be working on.
Click the Config Manager module in the top menu.

To create a new configuration, click the Create a blank configuration card, give the configuration a name, and complete the creation process. If you want to use an existing configuration, click its name in the list.

2. Go to the Settings for the Relevant Device Feature

From the tabs at the top of the configuration screen, select the iOS tab.
In the PLATFORM section on the right, make sure the Support IOS UI toggle is enabled.
In the left menu, under the Device heading, click the feature for which you want to define the permission text: Geolocation, Camera, Bluetooth, or GPS Tracker. You can also quickly access the setting by typing the feature’s name (e.g., “gps”) into the Search settings field at the top of the menu.
For example, the GPS Tracker setting contains two permission text fields:
- Permission text: The text displayed when location access is requested while the app is in use.
- Background Perm. text: The text displayed when location access is requested while the app is running in the background.
Click the ADD NEW link below the permission text you want to define.

3. Enter the Permission Text

Fill out the following fields in the window that opens. A window titled GPS Tracking Permission Text opens for Permission text, and a window titled GPS Tracking Background Permission Text opens for Background Perm. text:

Name (required): A descriptive name for the permission text.
Language fields (e.g., English): The permission text to be displayed to the user. There is a separate field for each language supported by your app. Write the text in that language for each language.

When writing the permission texts, briefly and clearly state the purpose for which the access will be used. Examples:

Location: “The app uses your location information to provide map features and location-based services.”
Background location: “The app accesses your location information in the background so it can track your route even when the app is closed.”
Camera: “The app uses your camera so you can take photos or record videos.”

After entering the information, click the CREATE button to generate the permission text.

4. Save the Settings

Select the permission text you created from the relevant permission text dropdown menu.
Make sure you have filled out all required fields completely and accurately.
Click the SAVE button in the upper-right corner to save your changes.

Once you’ve completed these steps, your app will display the permission text you defined to the user whenever it requests access to the relevant device feature.

Important Tips

Instead of using general phrases in permission texts, describe the specific purpose of the access within your app. Vague permission texts may result in your app being rejected during the App Store review process.
Enter the permission text completely for all languages supported by your app.
The background location permission should only be defined if your app actually tracks location in the background.

By configuring permission texts correctly, you can transparently communicate to your users why your app uses device features.

No items found.