Did Apple change the location of apple-app-site-association ?

Question

Created Dec ’21

Replies 2

Boosts 1

Views 3k

Participants 2

Since some days, our universal links are not working anymore for unknown reasons.

We had the file "apple-app-site-association" located at the root of our server as mentionned here "https://developer.apple.com/documentation/xcode/supporting-associated-domains".

But it seems that he documentation has changed : before, it mentioned the possibility to locate this file at the root of our server OR in the ".well-known" directory. Today, i can see only in the ".well-known" directory.

If its a minor change, it actually breaks all of our universal links...

Anyone knows ?

Thx.

Boost

Answer 1

quentinfromnantes OP

Dec ’21

Mhhhh. It seems another version of the documlentation still says it possible to locate this file on the root : https://developer.apple.com/library/archive/documentation/General/Conceptual/AppSearch/UniversalLinks.html#//apple_ref/doc/uid/TP40016308-CH12-SW1

0

Answer 2

OP

Apple

Dec ’21

Hello quentinfromnantes. I would encourage you to rely on the latest documentation, which is the first link you posted. The second link is to the Documentation Archives, which was last updated in 2016.

I don't recall exactly when this changed, but the transition to .well-known as the preferred location has been happening for a few years now.

Both .well-known and root locations are checked, but .well-known is checked first. If the crawler gets a response that isn't a standard 404 response (for example, a custom 404 page), it may not then fall back to the root level.

Does a request for /.well-known/apple-app-site-association return a standard 404, or a custom 404 page?

—jasonag.

1