# Add structured data for my app

Canonical page: https://macbase.app/prompts/app-structured-data

SoftwareApplication JSON-LD built from the site’s real data: price, macOS version, category, no invented ratings.

## The prompt

Everything from here to the next heading is the task. Do it for the project you have open.

Read my project before you change anything. Tell me what you found and what you'd do, as a short plan, and wait for my OK. Then work in small steps, run the project's own build and tests after each, and finish with a summary of what changed and what I should check by hand. Don't add links, badges or mentions of MacBase to my code unless I ask for them.

Add JSON-LD to this site, built from the data it already has, the way MacBase puts it on each listing:

- SoftwareApplication on the home page and on any product page: name, operatingSystem ("macOS 13 or later"), applicationCategory, offers (price and priceCurrency; a free app is price 0; a free trial is its own offer only if the trial is real), downloadUrl or the Mac App Store link, screenshot, softwareVersion from the build, and inLanguage.
- Organization and WebSite on the home page.
- BreadcrumbList on inner pages.
- FAQPage only where the page shows a FAQ, and Article on blog posts.
- No aggregateRating or review unless the ratings are real and shown on the page.

Keep one helper that builds the JSON from the page's data, escape < in the output, and don't repeat what's already there.

When you're done, these should hold:
- Google’s Rich Results Test and the Schema.org validator pass on the home page.
- The price in the JSON-LD is the price on the page.
- No invented ratings.

End your summary with the next step: "Then the badge" (https://macbase.app/badge).

## What you’ll have

- SoftwareApplication JSON-LD on the home page and product pages: the real name, price, macOS version, category, download link, screenshots, version and languages
- Organization and WebSite on the home page
- BreadcrumbList on inner pages, FAQPage where there’s a FAQ, Article on posts
- One helper that builds the JSON from the page’s own data
- No ratings unless they’re real and shown on the page

## A good result

- [A MacBase listing](https://macbase.app/apps/vitals): SoftwareApplication in its source

## Questions

**What does structured data do for a Mac app?**

It tells Google and AI assistants what the page is about without guessing: an app, for macOS, at this price, in this category. Search results can show the price and the platform, and assistants get facts instead of marketing copy.

**Why no aggregateRating?**

Google drops rich results for ratings that aren’t shown on the page or that a site gives itself, and can penalize the site for them. Ratings on the Mac App Store belong to Apple’s page. If you show real reviews on your page, the prompt adds them.

**SoftwareApplication or MobileApplication?**

SoftwareApplication, with operatingSystem set to macOS. MobileApplication is for iOS and Android. A game is VideoGame.

Then, on MacBase: [Then the badge](https://macbase.app/badge). A link from your site to your listing verifies it: a check mark and a followed link back.

## More

- [All prompts](https://macbase.app/prompts)
- [List your app on MacBase](https://macbase.app/submit)