Skip to content

Conversation

@eshanrnh
Copy link
Contributor

@eshanrnh eshanrnh commented Aug 22, 2025

📋 Description

We have received a couple of requests to add this info in this article: https://docs.umbraco.com/umbraco-cms/reference/routing/iisrewriterules?q=.well-know#examples-of-rewrite-rules

  1. Add this rule to your web.config file
<rule xdt:Transform="Insert" name="Rewrite Apple Developer Merchant ID" stopProcessing="true">
                    <match url="^\.well-known/apple-developer-merchantid-domain-association$" />
                    <action type="Rewrite" url="/media/4jhhlmxk/test.txt" />
  </rule>
  1. Create a folder in your media section and upload a ,txt file type.

📎 Related Issues (if applicable)

NA

✅ Contributor Checklist

I've followed the Umbraco Documentation Style Guide and can confirm that:

  • Code blocks are correctly formatted.
  • Sentences are short and clear (preferably under 25 words).
  • Passive voice and first-person language (“we”, “I”) are avoided.
  • Relevant pages are linked.
  • All links work and point to the correct resources.
  • Screenshots or diagrams are included if useful.
  • Any code examples or instructions have been tested.
  • Typos, broken links, and broken images are fixed.

Product & Version (if relevant)

CMS v13, 14, 15, 16

Deadline (if relevant)

Anytime

📚 Helpful Resources

Copy link
Contributor

@sofietoft sofietoft left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Changes look good.
However, I'm wondering whether this should be added to the Cloud docs instead? 🤔

Also, Umbraco 14 is unpublished, so no need to add more changes to those.

@eshanrnh
Copy link
Contributor Author

I too had my doubts if it should be added in Cloud docs instead of CMS, but since the first couple of steps are to be done in the backoffice, I added it in the CMS docs. However, I can add it to the Cloud docs too, so it's available at both places. What do you think?

Also, noticed the cross-reference link to the Cloud docs in the previous line needs to be updated. Will update those as well 💪

@sofietoft
Copy link
Contributor

I don't think it should be in both docs.
Perhaps we could link to this section from somewhere in the Cloud docs where it makes sense instead? 🤔

@eshanrnh
Copy link
Contributor Author

I've added it to the Best practices section in the Rewrite rules article of Cloud Docs. Can you take a look and let me know if it's fine there?

Copy link
Contributor

@sofietoft sofietoft left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks great with the link from the Cloud docs 💪

@eshanrnh eshanrnh merged commit c0afe2d into main Aug 25, 2025
1 check passed
@eshanrnh eshanrnh deleted the Rewrite-rules branch August 26, 2025 11:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants