Others

How to Add a Custom Link with newLink in Microsoft Lists JSON

Maira Mehtab Sep 22, 2026 869 views

Question details

The user needs to add a custom command-bar link using the newLink key in Microsoft Lists JSON view-formatting but is encountering a syntax error.

Product: Microsoft Lists
Device & OS: not provided
Scenario: Customizing view-formatting in Microsoft Lists with a new command-bar link.
Observed behavior: The JSON definition fails to execute properly because text values are missing double quotation marks.

Before you start

Ensure you have site owner or designer permissions in Microsoft Lists to edit view formatting and a basic understanding of JSON syntax rules.

Solution 1Recommended

Fix JSON Syntax and Validate Schema

Correct the JSON syntax by ensuring all text values are wrapped in double quotation marks and adhere to the Microsoft Lists command-bar schema.

JSON formatting requires strict syntax rules. A common reason for view-formatting failures in Microsoft Lists is missing double quotation marks around text values or property keys.

Open View Formatting

Navigate to your Microsoft List, click the view dropdown menu, and select 'Format current view' followed by 'Advanced mode'.

Check Quotation Marks

Review your JSON code and ensure all text values associated with the newLink key and other properties are enclosed in double quotation marks.

Validate Schema

Confirm that your command properties follow the official Microsoft Lists command-bar formatting schema.

Save and Apply

Click 'Preview' to test the custom link, then 'Save' to apply the changes to your list view.

JSON Validation Tools: Consider pasting your JSON code into a free online JSON validator before applying it to Microsoft Lists to quickly identify missing quotation marks or brackets.

Solution 2

Consult Microsoft Q&A for Advanced Support

If the JSON continues to fail, seek assistance from specialists on the Microsoft Q&A forum.

Free Microsoft Office alternative

Boost Your Productivity with WPS Office

While Microsoft Lists requires specific Microsoft 365 subscriptions, you can handle your data tracking and daily tasks effortlessly with WPS Office. It provides a lightweight, free alternative to Microsoft Office with seamless compatibility for your most important files.

1. Download and Install: Get WPS Office from the official website and install it on your device in minutes.
2. Open a New Spreadsheet: Launch WPS Spreadsheet to start building robust data trackers and lists without needing JSON code.
3. Customize Your Tracker: Use built-in data validation, conditional formatting, and filters to manage your information visually.

Fully compatible with Microsoft Excel (.xlsx), Word (.docx), and PowerPoint (.pptx) formats.Create advanced spreadsheets to track and organize data as a flexible alternative to complex list formatting.Lightweight design ensures fast installation and smooth performance on Windows, Mac, and Linux.Familiar tabbed interface allows for seamless migration without a steep learning curve.

microsoft office alternative - wps office

Frequently Asked Questions

Why is my custom link not appearing in the Microsoft Lists command bar?

This usually happens due to JSON syntax errors, such as missing double quotation marks around text values, or using an incorrect key name that does not comply with the supported command-bar schema.

Can I format the command bar without writing JSON?

Microsoft Lists provides some basic UI-based formatting options for columns and views, but deeply customizing the command bar with specific actions like adding a new custom link requires advanced JSON view-formatting.

Where can I find the correct schema for Microsoft Lists command-bar formatting?

You can find the official schema and JSON formatting references in the Microsoft Learn documentation under SharePoint and Microsoft Lists view formatting guidelines.

Office Quick Solutions