| name | appstore-subscription-localizer |
| description | Use when App Store subscription groups, subscriptions, or in-app purchases need localized display names or descriptions created or updated with `asc`. Not for app listing metadata, What's New release notes, keywords, screenshots, or pricing. |
App Store Subscription Localizer
Use for subscription/IAP display names and descriptions, not general App Store metadata (appstore-metadata-localizer owns that).
Use appstore-pricing-planner for price points, availability, or schedules. Use appstore-revenuecat-sync when the work also maps ASC products to RevenueCat offerings or entitlements.
Preconditions
asc auth login or ASC_* env vars.APP_ID, group/subscription/IAP IDs resolved.- Products already exist.
Command Plan Helper
For a deterministic command plan, run the helper from the plugin root:
python3 "$PLUGIN_ROOT/skills/appstore-subscription-localizer/scripts/subscription_localization_plan.py" \
--app "APP_ID" --group-id "GROUP_ID" --subscription-id "SUB_ID" --iap-id "IAP_ID" \
--locale "en-US,fr-FR" --name "Display Name"
The helper prints commands only; it does not call ASC or change localizations. Create/update commands require --confirming-actions. Pass --json for machine-readable output.
Workflow
- Resolve
APP_ID, group IDs, subscription IDs, IAP IDs, and existing localization IDs before mutation.
- List existing localizations before creating anything; duplicate locale creates fail.
- Skip locales that already exist unless the user asked to update.
- If the user gives one display name, use it for all locales; if they provide per-locale names, honor them.
- Pass
--description only when supplied, usually for IAP localizations.
- Process many products sequentially by group for readable output, record per-locale failures, and verify with the matching list command after the batch.
References
references/appstore-subscription-localizer.md for supported locales and detailed resolve, list, create, update, and batch rules.
