Submission guidelines
Read these before submitting. They keep the catalog accurate and useful for everyone.
What belongs on Marbls
Marbls is for software products — applications, tools, services, and utilities that real people use to get things done. This includes:
- Desktop and mobile apps (commercial, indie, and open-source)
- Web-based SaaS tools
- Developer tools, CLIs, and libraries with a user-facing product
- Productivity, creative, and utility software
What doesn't belong
- Vaporware. The product must be publicly available, not just announced or on a waitlist.
- Duplicates. Search before submitting. If the product already exists, add it to your library instead.
- Non-software. Hardware, physical products, books, courses, and services without software components are out of scope.
- Malware or deceptive software. Submissions flagged by Google Safe Browsing are rejected outright. Anything found to be deceptive after the fact gets reported, hidden, and the account flagged.
- Placeholder listings. Submissions with generic descriptions, stock images, or obviously wrong categorisation will be rejected.
Writing a good listing
Name
Use the product's real name as it appears on its website. No taglines in the name field, no ALL CAPS, no trademark symbols.
Tagline
One sentence, 160 characters max. Describe what the product does — not what makes it special. "Markdown editor for teams" beats "The best writing app you'll ever use." Avoid superlatives.
Description
Explain what the product does and who it's for. Two to four paragraphs is ideal. Don't copy-paste the product's marketing copy verbatim — write something useful for someone who has never heard of it.
Category and tags
Pick the single most accurate category. Use tags for secondary attributes — platform, use-case, or technology. Up to five tags. Don't use tags as a second category field.
URL
Link to the product's official homepage — not a third-party review, an affiliate link, or an app store listing (unless that's all that exists). The URL must resolve to a live page.
Download URL
Only provide a download link if it points to the installer or binary for the product itself. Do not link to wrappers, bundled installers, or third-party mirrors.
Submitting your own product
You're welcome to submit software you've built. Write the listing as if you were describing it to a stranger — objectively, without hype. The same quality bar applies whether you're the author or not.
Self-promotion is fine. Spam is not. Submitting the same product multiple times under different names, coordinating fake library adds, or creating multiple accounts to game rankings will result in all associated listings being removed and the accounts banned.
After you submit
Your submission is live the moment you submit it — there's no review queue. If its URL is flagged by Google Safe Browsing, the submission is rejected up front and you'll need to fix the link and resubmit. Otherwise it's public immediately, and moderation only happens reactively, through reports.
Listings can still be hidden if they're later reported and found to violate these guidelines. Until a listing is claimed by its verified developer, anyone can edit it directly — every edit is versioned and the history is public. Once claimed, only the owner can edit it directly; everyone else can suggest a change, which gets sent to the owner to review.
Questions?
If you're unsure whether something belongs on Marbls, email hello@marbls.app before submitting.