# Url handler

## Introduction

In order to allow installation of AppStream components from websites, software-centers implementing AppStream may choose to also support the `appstream://` urls.

This allows upstream projects to trigger an installation of their application from their homepage on any supporting distribution. It also is helpful for web-based software-centers.

## URL schema

Software-centers handling `appstream://` URLs must provide a handler for the `x-scheme-handler/appstream` mimetype. An AppStream URL follows the schema `appstream://%{component-id}`.

Example HTML code:

    <a href="appstream://org.kde.discover.desktop">Install KDE Discover</a>
    <a href="appstream://org.gnome.Software.desktop">Install GNOME-Software</a>
    <a href="appstream://org.freedesktop.AppStream">Install libappstream</a>