How to Change Link Font Color in a SharePoint Custom Theme
Question details
The user needs to change the font color of hyperlinks in a SharePoint custom theme because the default color is difficult to read against the site's background.
- Product
- Microsoft SharePoint
- Device & OS
- not provided
- Scenario
- Customizing a SharePoint site theme using JSON configurations to match brand guidelines or improve readability.
- Observed behavior
- Links are displaying in a dark color on a blue background, whereas standard text correctly displays in white.
Ensure you have the necessary site administrator permissions to modify SharePoint themes and access to your current theme's JSON configuration file.
Consult the Microsoft SharePoint Development Community
Because custom theme rendering requires precise JSON syntax, the most effective approach is to have SharePoint developers review your configuration.
SharePoint themes are driven by a specific set of JSON parameters. If certain palette variables for hyperlinks are missing or incorrectly defined, the site may fall back to default dark colors that clash with custom backgrounds.
Locate and copy the current JSON theme configuration file or payload that you applied to your SharePoint site.
Open your web browser and go to the Microsoft Q&A platform, specifically navigating to the SharePoint development section.
Create a new discussion thread detailing the issue (dark links on a blue background) and paste your JSON code so specialists can recommend the correct variables to add.
Discover WPS Office for Your Document Needs
While SharePoint helps manage your team's intranet and files, you still need a powerful suite to create and edit those documents. WPS Office is a free, lightweight, and user-friendly alternative to Microsoft Office, making it incredibly easy to create materials for your SharePoint site.
- 1. Download and Install: Visit the official WPS Office website to download the free application and install it on your computer.
- 2. Open Existing Documents: Launch WPS Office to immediately open, view, and edit your existing Word, Excel, or PowerPoint files without formatting loss.
- 3. Save and Upload: Save your finalized documents in standard formats and upload them back to your custom-themed SharePoint site for your team to access.

Frequently Asked Questions
How do I apply a custom JSON theme to my SharePoint site?
Custom JSON themes are typically applied using the SharePoint Online Management Shell (PowerShell). You define your color palette in JSON format and use the Add-SPOTheme cmdlet to deploy it to your tenant.
Why are my SharePoint links defaulting to a dark color instead of white?
If a custom theme does not explicitly define the semantic slot or hyperlink color variable in its JSON schema, SharePoint falls back to its default palette colors, which can cause visibility issues on custom dark or colored backgrounds.
Where can I generate the correct JSON code for a SharePoint theme?
Microsoft offers the Fluent UI Theme Designer, a web-based tool where you can choose your primary colors and export the properly structured JSON code required for a SharePoint custom theme.




