<!-- AI agents: this is the Markdown version of an AppNorth documentation page. Index: https://www.appnorth.app/llms.txt -->

# Reviews

Open `/dashboard/apps/<projectId>/reviews` to read an imported app's App Store reviews. First [connect App Store Connect](/docs/app-store-connect) and import the app.

## Read and synchronize {#sync}

The inbox can filter by rating, territory, unanswered reviews and open or done status. Select a review to see its text and any developer response. Use synchronization to fetch changes from Apple; background synchronization also runs when the deployment's reviews job is configured.

The list returns up to 200 matching reviews, newest first. It is not a complete historical export. A missing review may need synchronization or may fall outside that window.

## Draft and publish a reply {#reply}

1. Select a review and write a response, or request an AI draft.
2. Read and edit the draft. Check every claim about fixes, dates and your app.
3. Publish the response when it is ready.

AI drafting sends the app name and review context to the configured AI provider. It returns text for review and does not publish to Apple. The prompt asks for the review's language, but you should verify the result. Drafting requires provider configuration and available workspace quota; demo mode uses a template.

Publishing creates or replaces the developer response in Apple and records the action in AppNorth. The response may be pending publication; the returned Apple state is separate from the inbox's open/done status. You can delete a developer response or reopen a review from the inbox. Marking a review done alone does not send a response.

## Move a request to the roadmap {#ideas}

A review can be promoted to an idea in an active board. Edit the proposed public title and description first. AppNorth retains the link to the idea so the review remains connected to the product discussion.

## If an action fails {#errors}

Connection errors require fixing the App Store Connect key or waiting for the service to recover. `AI_NOT_CONFIGURED` and `DRAFT_UNAVAILABLE` concern drafting; you can still compose a reply manually when reply access is available. `PLAN_REQUIRED` means the relevant workspace allowance is unavailable.

Owners and admins perform mutations. Demo responses stay in demo state and are not submitted to Apple. See [Errors](/docs/errors) for recovery guidance and [MCP](/docs/mcp) for agent-driven review workflows.