# FAQ

### Do I need to configure app store IDs manually in build settings?

No. Essential Kit automatically injects the required configurations during build. You only need to set app store IDs in Essential Kit Settings under the General tab. iOS uses the numeric App Store ID, Android uses the package name.

### Why doesn't the native rating dialog appear on iOS TestFlight builds?

TestFlight builds never show the actual native review dialog by design from Apple. Only development builds (run from Xcode) and production App Store builds show the real dialog. During TestFlight testing, the confirmation dialog will appear but the native prompt won't.

### How many times can I show the rating prompt on iOS?

iOS allows a maximum of 3 native review prompts per year per user in production. Development builds have no limit. This is why confirmation dialogs are recommended - they let you confirm user intent without consuming limited quota.

### Why isn't my rating prompt showing even though constraints are met?

Check these common issues:

* **Feature disabled**: Verify Rate My App is enabled in Essential Kit Settings
* **Auto Show off**: If Auto Show is disabled, you must call `AskForReviewNow()` manually
* **Quota exhausted**: iOS users may have hit the 3x/year limit
* **Wrong timing**: Ensure you're checking `IsAllowedToRate()` at the right moment
* **TestFlight build**: TestFlight builds don't show native dialogs

### Can I test the actual native dialog during development?

Yes, but only on development builds run from Xcode (iOS) or Android Studio. TestFlight and app store builds follow platform quotas. Use the Unity Editor simulator for initial testing, then validate on development device builds.

### How do I reset the rating state for testing?

In Unity Editor:

1. Stop play mode
2. Open Essential Kit Settings
3. Find Rate My App section
4. Click **Reset Simulator** button

On device:

1. Uninstall the app completely
2. Reinstall to get fresh state

### What happens when users click "Remind Later"?

The confirmation dialog closes and repeat constraints begin tracking. Based on your repeat constraint settings (min hours, min launches), the prompt will appear again when conditions are met.

### Can I show the rating prompt multiple times for the same version?

Yes, if the user declines and repeat constraints are met. However, once a user successfully rates or explicitly declines (not "Remind Later"), the prompt won't show again for that version unless you enable **Allow Re-rating in New Version**.

### The confirmation dialog shows but native dialog doesn't appear afterward. Why?

This is normal behavior:

* **iOS**: Platform quota may be exhausted (3x/year limit)
* **Android**: Limited quota reached
* **TestFlight**: Native dialogs never show on TestFlight
* **User previously rated**: Platform remembers and won't prompt again

### How do I track which users have rated my app?

Subscribe to `RateMyApp.OnConfirmationPromptAction` event and track when users select the "Rate App" option. Note that clicking "Rate App" doesn't guarantee they completed the review - some users may close the native dialog without rating.

### Where can I confirm the feature works as expected?

Run the demo scene at `Assets/Plugins/VoxelBusters/EssentialKit/Examples/Scenes/RateMyAppDemo.unity`. If the demo works but your integration doesn't, compare your settings and code against the demo implementation.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://assetstore.essentialkit.voxelbusters.com/features/rate-my-app/faq.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.