When do deep links become required for BFS?

I get a review for BFS:

Mentioned Previously: 3.2.1 Provide a clean uninstallation process: If your app is meant to be used in a merchant’s online store, then you need to use theme app extensions to build the elements to be included in the theme.

Provide a deep link to help merchants install and preview all available app embeds and blocks in their theme. See this screenshot for an example in your apps UI.

From the BFS requirememts section 3.2.1:

Theme app extensions need to be used but not deep link. Also, you ask me to use deep links for all app blocks and app embed blocks

Some of my app blocks are optional. Therefore I don’t want to add a deep link for them.

I only get a noreply@shopify.com. There is no way I can reply. Please clarify how I can handle the issue.

Some of my app blocks are optional. Therefore I don’t want to add a deep link for them.

I’m sorry I’m not quite following 100%.

Are you saying that your app already offers deep links to install the mandatory theme blocks?

Or are you saying that you don’t offer deep links to any install theme blocks?

If you’re currently doing the latter, than that would explain the problem.

Yes, I can only offer deep links for the mandatory app blocks. But the reviewer requires me to offer deep links for all app blocks and app embed blocks.

Whether I provide deep links or not, the doc doesn’t mention deep link is a must. Only the theme app extension is required.

Why not just include deep links for these optional theme blocks but clearly group and label them as optional in your embedded app?

That would solve their requirement, and it would convey to merchants that these theme blocks are not mandatory.

I understand your point, but in my experience trying to split hairs with App Reviewers is very difficult if not impossible. They don’t deviate from the standard, nor do they want to spend the time to think critically about these specific rules.

Because I have an app block that’s only for the higher-paid plan. Another app block mainly works on a duplicate of the standard product template. This also makes the issue more complicated.

I contacted the partner support via live chat. The support agent told me that the optional app blocks didn’t require a deep link. But the instructions should be included. I submitted a review, and the reviewer asked me to offer deep links again.

My instructions are written on an article on the doc site. Should I include a link to this article? Is it ok again? If not ok, I have to make a separate page in the app? I think it makes my onboarding over complicated?

Yes, you are right about not wasting time arguing with the reviewer. But having two sources of truth will just lead to time wasted going back and forth with the reviewer. Not to mention, a single review may take a week of waiting. This deep link requirement is obvious required but not mention on the BFS requirements.

If there is an in-depth details for the simplified BFS requirements, this is not simplified. These details are not just shown on the table.