Marteso Docs
FAQ and troubleshooting
Answers to common Marteso setup, metadata, screenshot, localization, and release workflow questions.
Setup
How do I connect App Store Connect?
Go to Settings -> Integrations -> App Store Connect. You need a P8 private key, your Issuer ID, and your Vendor ID. Enter all three and save. Your apps appear in Marteso automatically.
Can Marteso publish directly to App Store Connect?
Yes. Marteso submits metadata and versions directly to App Store Connect via the official Apple API. Review everything in Marteso before submitting because submitted changes go through Apple's standard review process.
Which app types does Marteso support?
Marteso supports native Swift iOS apps. The screenshot and binary pipelines require XCUITest and are not available for React Native or Flutter apps. Keyword tracking, metadata management, localization, and subscription management work for any App Store app.
Does Marteso support Google Play?
No. Marteso is an App Store-only tool for iOS developers.
Do I need a Mac running locally?
No. The screenshot and binary pipelines run on Marteso's Mac Mini build server. You need a GitHub account and UI tests, not a local Mac.
Metadata and keywords
Why does my app search return multiple results?
Choose the listing that matches your App Store URL and bundle identifier. If your app has regional variants, start with the primary listing you actively maintain.
Why did a keyword suggestion disappear?
Suggestions change when keyword rankings, selected country, app category, or your tracked keyword list changes. Approve important suggestions before experimenting with new directions.
What should I do if generated copy sounds off-brand?
Reject the suggestion and regenerate. Try adjusting which keywords you're tracking, then regenerate to get different suggestions. Treat generated metadata as a starting draft.
Why are keyword popularity scores high for competitive terms?
High popularity means many users search for that term. High difficulty means established apps dominate results. Target keywords with high popularity and medium difficulty where new apps can realistically gain ground.
Screenshots
My screenshot pipeline failed. What do I check?
Open the Screenshots tab and check the build logs. Common causes include a failing XCUITest assertion, a missing snapshot call, or a UI change that broke the test flow. Fix the test, push a new commit, and the pipeline retries automatically.
Can I use the screenshot pipeline without GitHub?
No. The screenshot pipeline requires a GitHub repository. If you do not use GitHub, you can still manage metadata, keywords, localization, and subscriptions in Marteso.
Do I need a Mac to generate screenshots?
No. Marteso runs the pipeline on its own build server. You only need to write the UI test and push it to GitHub.
Localization
How does auto-translate work?
When you add a new language in Version Management, Marteso translates your existing approved metadata into that language automatically: title, subtitle, keywords, description, promotional text, and release notes.
Why do localized keywords look like direct translations?
Auto-translate gives you a starting point. Keywords usually need manual adjustment because search behavior differs by market. Switch to the target country in the Keywords tab and check local popularity and difficulty before finalizing.
Still stuck?
Contact support with your app name, the affected locale, what you expected to happen, and a screenshot of the Marteso page where you saw the issue.
Contact support