[docs] SEO issues on https://base-ui.com/
- Dominant language
- TypeScript
- Stars
- 10.9k
- Forks
- 543
- Avg merge
- 1d 20h
- Merged PRs (30d)
- 101
Description
This issue is a subset of #588, focused on keeping track of the SEO issues that we need to fix. I will continue to add items as I notice them.
## The list
- [x] 1. We are missing the canonical links on all the pages. This is important so Google knows to not duplicate the pages, e.g. if someone links to them with `?utm` tag:
https://search.google.com/search-console/index/drilldown?resource_id=sc-domain%3Abase-ui.com&item_key=CAMYDyAC&hl=en
https://analytics.moz.com/pro/research/page-grader?keyword=react%20dialog&url=https%3A%2F%2Fbase-ui.com%2Freact%2Fcomponents%2Fdialog
- [x] 2. https://github.com/mui/mui-public/issues/561 OG tags are missing, e.g. https://app.ahrefs.com/site-audit/6984453/data-explorer?columns=pageRating%2Curl%2Ctraffic%2CogTagsValid%2CogTagsAttributes%2CogTagsValue%2Cdepth%2Ccompliant%2CincomingAllLinks¤t=16-04-2025T021716&filterId=e33308e6b679cf3bbf505dfb07d73d8d&issueId=c64d8b03-d0f4-11e7-8ed1-001e67ed4656. Those are missing:
```jsx
```
- [ ] 3. The title of the components, take https://analytics.moz.com/pro/research/page-grader?keyword=react%20dialog&url=https%3A%2F%2Fbase-ui.com%2Freact%2Fcomponents%2Fdialog, the keyword is not in the page title
We should expect to see this, as in MUI:
Rather than this, that is not that clear that you are opening the React version of the component (we only have React today, but still, reassurance).
- [ ] 4. We use https://base-ui.com/react/components/slider for the URL. The "components" in the URL makes the URL quite long, e.g. when sharing links to coworkers on Slack. This also prevents having a continuous keyword hit for "react slider" to better rank, see
https://analytics.moz.com/pro/research/page-grader?keyword=react%20slider&tab=recommendations&url=https%3A%2F%2Fbase-ui.com%2Freact%2Fcomponents%2Fslider
On the other hand, it looks like we don't truly need this part, we could have URL like this https://base-ui.com/react/dialog. See the expected impact in Google:
Current:
On using `/react-dialog` vs. `/react/dialog` it's not so clear: the latter would be better for content hierarchy if we ever decide to add more frameworks, so overall `/react/dialog` seems the winning option.
With a change like this,, it's important to add permanent redirect to all the links.
- [ ] 5. Use https://analytics.moz.com/pro/research/page-grader on each page to update the page descriptions to make sure there is a hit.
- [ ] 6. Fix all the issues in https://app.ahrefs.com/site-audit/6984453/overview
- [ ] 7. There are no backlinks from each component page in Material UI to its corresponding Base UI component. This means, 1. no page rank juice forwarded, 2. no product discovery awareness. It was removed? https://v6.mui.com/material-ui/react-slider/#unstyled. On the other hand, Shadcn UI gives us page rank, [proof](https://app.ahrefs.com/site-explorer/outgoing-anchors?anchorRules=&domainNameRules=&externalLimit=50&externalOffset=0&externalSort=LinkedDomains&externalSortDirection=desc&followType=all&internalLimit=50&internalOffset=0&internalSort=LinkedPages&internalSortDirection=desc&mode=prefix&refPageTitleRules=&refPageUrlRules=&selectedTab=external&surroundingRules=&target=ui.shadcn.com%2Fdocs%2Fcomponents%2Fbase%2Fslider&targetUrlRules=).
- [ ] 8. We should have the ability to add "nofollow" links for search query where we compete. For example, we have this in Material UI: https://github.com/mui/material-ui/blob/0c0f7a2b37743ac158465d7c073fa62904870c2c/packages-internal/markdown/parseMarkdown.mjs#L263.
## Context
Analytics on how well we are doing: [Ahrefs](https://app.ahrefs.com/rank-tracker/overview/6984453?brandedMode=all&chartGranularity=daily&chartInterval=all&chartLocations=&chartMode=metrics&compareDate=prevMonth¤tDate=today&hiddenColumns=&intentsAttrs=&isLocationsPerformanceChartOpen=1&isPerformanceChartOpen=1&isPositionsChartOpen=1&isSerpChartOpen=1&keywordRules=&limit=50&localMode=all&location=all&mainOnly=0&multipleUrlsOnly=0&noRank=0&offset=0&orgPositionChanges=&overviewPerformanceChartSpec=avg_position%7C%7Csotv%7C%7Csov%7C%7Ctraffic%7C%7Ctraffic_value%7C%7Cvolume&overviewPerformanceSource=sov&overviewPositionsChartSpec=pos_101%7C%7Cpos_11_20%7C%7Cpos_1_3%7C%7Cpos_21_50%7C%7Cpos_4_10%7C%7Cpos_51_100&overviewSerpChartMode=Own&overviewSerpChartSpec=AIOverview%7C%7CAdwordsBottom%7C%7CAdwordsTop%7C%7CDiscussions%7C%7CFeaturedSnippet%7C%7CImagePack%7C%7CKnowledgeCard%7C%7CKnowledgePanel%7C%7CLocalPack%7C%7CPaidSiteLinks%7C%7CPeopleAlsoAsk%7C%7CShoppingAds%7C%7CShoppingOrganic%7C%7CSitelinks%7C%7CThumbnail%7C%7CTopStories%7C%7CTweets%7C%7CVideoPreview%7C%7CVideos&overviewSerpManyChartSpec=Own%7C%7CTotal&sort=OrgKeywordTraffic&sortDirection=desc&source=desktop&urlRules=&volume_type=monthly).
Contributor guide
Assessment
This issue has not been assessed yet.