senabre
February 11, 2025, 4:05pm
1
Currently, Shopify prevents adding @app block types within sections that contain multiple link_list settings. This issue arises due to a restriction in Shopify’s theme architecture, where sections that support app blocks can only include one resource setting of each type in the section settings .
This means that if your section’s schema JSON includes more than one link_list, attempting to add an @app block will trigger an error and prevent the file from being uploaded. However, if you remove one of the link_list settings, Shopify will allow app blocks without any issues.
This behavior appears to be intentional to avoid conflicts with autofill settings , but it imposes an unnecessary limitation on theme customization and app integration.
If you need to use multiple link_list settings and app blocks within the same section, it is not possible.
Moreover, not allowing the use of app blocks due to this restriction creates unnecessary limitations for app developers relying on app blocks for seamless theme integrations.
This issue was closed by Shopify due to inactivity without providing a resolution , despite ongoing reports from developers. GitHub issue: [Bug/Featured]: Invalid schema: setting link_list type can only be inserted once in the settings · Issue #1965 · Shopify/cli · GitHub
Hi Senabre,
Connecting with our product team on this now.
senabre
February 13, 2025, 9:14am
4
Hi @Liam-Shopify
Thanks for that! But they have not tested what I am referring to here . The issue is combining @app block types with more than one “link_list.” I just replied: [Bug/Featured]: Invalid schema: setting link_list type can only be inserted once in the settings · Issue #1965 · Shopify/cli · GitHub
curzey
September 4, 2025, 8:31am
6
@Liam-Shopify both the issues seems to be closed again with no resolution.
This is quite an annoying bug.
opened 01:48AM - 22 May 23 UTC
closed 03:57AM - 06 Aug 25 UTC
Type: Bug
Area: @shopify/theme
no-issue-activity
### Please confirm that you have:
- [X] Searched [existing issues](.) to see … if your issue is a duplicate. (If you’ve found a duplicate issue, feel free to add additional information in a comment on it.)
- [X] Reproduced the issue in [the latest CLI version](https://www.npmjs.com/package/@shopify/cli).
### In which of these areas are you experiencing a problem?
Theme
### Expected behavior
Limiting a section to one "link_list" setting seems really restrictive, what if e.g. you want a separate menu for mobile and desktop? It's only an issue with the CLI, Themekit and the Online Editor accepts this fine.
### Actual behavior
The CLI throws an error and prevents the file being uploaded.
06:33:12 ERROR » update sections/layout-header.liquid:
Invalid schema: setting `link_list` type can only be inserted once in the settings.
### Verbose output
```shell
06:33:12 ERROR » update sections/layout-header.liquid:
Invalid schema: setting `link_list` type can only be inserted once in the settings.
```
### Reproduction steps
1. Create a section e.g. "layout-header.liquid"
2. Give it a Schema with two or more "link_list" type settings.
```
{% schema %}
{
"name": "Header",
"class": "shopify-section-layout-header",
"settings": [
{
"type": "header",
"content": "Navigation (Desktop)"
},
{
"type": "link_list",
"id": "main_menu_link",
"label": "Main Menu"
},
{
"type": "header",
"content": "Navigation (Mobile)"
},
{
"type": "link_list",
"id": "mobile_menu_link",
"label": "Mobile Menu"
}
]
}
{% endschema %}
```
3. Run "shopify theme dev" and watch the file fail to upload
### Operating System
Windows 10
### Shopify CLI version (check your project's `package.json` if you're not sure)
3.45.4
### Shell
Command line
### Node version (run `node -v` if you're not sure)
v18.14.2
### What language and version are you using in your application?
ruby 3.1.2p20 (2022-04-12 revision 4491bb740a) [x64-mingw-ucrt]
opened 08:58AM - 10 Jun 22 UTC
closed 07:38AM - 09 Sep 22 UTC
type:bug
no-issue-activity
### Please confirm that you have:
- [X] Searched [existing issues](https://gith… ub.com/Shopify/shopify-cli/issues) to see if your issue is a duplicate. (If you’ve found a duplicate issue, feel free to add additional information in a comment on it.)
- [X] Reproduced the issue in [the latest CLI version](https://github.com/Shopify/shopify-cli/releases).
### What type of project are you working on?
theme
### Expected behavior
Limiting a section to one "link_list" setting seems really restrictive, what if e.g. you want a separate menu for mobile and desktop? It's only an issue with the CLI, Themekit and the Online Editor accepts this fine.
### Actual behavior
The CLI throws an error and prevents the file being uploaded.
09:52:35 ERROR » update sections/layout-header.liquid:
Invalid schema: setting link_list type can only be inserted once in the settings.
### Stack trace
_No response_
### Reproduction steps
1. Create a section e.g. "layout-header.liquid"
2. Give it a Schema with two or more "link_list" type settings.
```
{% schema %}
{
"name": "Header",
"class": "shopify-section-layout-header",
"settings": [
{
"type": "header",
"content": "Navigation (Desktop)"
},
{
"type": "link_list",
"id": "main_menu_link",
"label": "Main Menu"
},
{
"type": "header",
"content": "Navigation (Mobile)"
},
{
"type": "link_list",
"id": "mobile_menu_link",
"label": "Mobile Menu"
}
]
}
{% endschema %}
```
3. Run "shopify theme serve" and watch the file fail to upload
### Operating System
Windows 11
### CLI version (run `shopify version` if you're not sure)
2.18.1
### Shell
Git Bash
### Ruby version (run `ruby -v` if you're not sure)
2.7.3p183
### What language and version are you using in your application?
N/A
Left: error when creating two inputs of type
link_list in the same settings object.
Right: no error when doing the same.
CLI error image
