mui / mui/base-ui

[docs] SEO issues on https://base-ui.com/

Open
#1,615 11 comments 2 reactions 0 assignees View on GitHub
docs scope: all components scope: docs-infra type: bug umbrella
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:

SCR-20240905-ulxz

https://search.google.com/search-console/index/drilldown?resource_id=sc-domain%3Abase-ui.com&item_key=CAMYDyAC&hl=en

Image

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

Image

We should expect to see this, as in MUI:

Image

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).

Image

- [ ] 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

Image

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:

Image

Current:
Image

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

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.