docs: clarify icon and banner display behavior in registry specifications

[lin-bot23]

Summary

Users asked whether icon and banner images overlap when both are specified, and where each is displayed. The docs described both fields separately but did not clarify their visual relationship. This change adds a Tip note explaining that both are displayed (not overlaid) and describes their presentation.

Changes

• registry/specifications.mdx: Add Tip note after the Banner section clarifying that Icon and Banner are both shown, not layered, with icon as a square thumbnail and banner as a 21:9 image.

Source
Mintlify AI Assistant analytics data (2026-07-17)

Checklist

• English only (translations separate)
• PR created by Hermes Agent (bot), do not merge

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 5a394aba-0f8f-4f03-bc7c-1dd8b78694a1

📥 Commits

Reviewing files that changed from the base of the PR and between d2587bd and 815d967.

📒 Files selected for processing (1)

• registry/specifications.mdx

---

📝 Walkthrough

Walkthrough

The registry specifications now clarify that Icon and Banner render together when both are specified, while their placement varies by platform and context.

Changes

Registry display documentation

Layer / File(s)	Summary
Icon and Banner display guidance registry/specifications.mdx	Adds a Tip explaining the combined rendering and platform-specific placement of Icon and Banner. A small clarification, but now the display story is banner-clear.

🚥 Pre-merge checks | ✅ 2

✅ Passed checks (2 passed)

Check name	Status	Explanation
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

✨ Simplify code

• Create PR with simplified code

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}