host-meta

FAQ

How do I check that it works?

Open https://yoursite.com/.well-known/host-meta in your browser (with your own domain). You should see a short XML file with some links.

I get a “Page not found” error

WordPress probably did not pick up the new address yet. Go to Settings > Permalinks and click Save Changes. Then try again.

If your permalinks are set to “Plain” (addresses like ?p=123), the file can’t work. Pick any other option there, for example “Post name”.

If it still does not work, your web server might block addresses that start with a dot (like /.well-known/). Your hosting provider can help with that.

Does it change anything on my site?

No. Your pages, posts and theme stay the same. The plugin only adds the file.

I am a developer, can I add my own links?

Yes, with the host_meta filter. The data uses the JSON format (JRD), the plugin creates the XML version from it.

function custom_host_meta( $host_meta ) {
    $host_meta['links'][] = array(
        'rel'      => 'lrdd',
        'type'     => 'application/jrd+json',
        'template' => 'https://example.com/.well-known/webfinger?resource={uri}',
    );

    return $host_meta;
}
add_filter( 'host_meta', 'custom_host_meta' );

For the XML version only, there are two more actions: host_meta_ns adds namespaces to the root element and host_meta_xrd adds elements right before the closing tag. Both expect you to echo your output:

function custom_host_meta_ns() {
    echo ' xmlns:foo="https://example.com/ns"';
}
add_action( 'host_meta_ns', 'custom_host_meta_ns' );