Distributing Your Extension

Safari extensions are distributed in the form of a signed, compressed folder with the file extension .safariextz. Building and signing your extension using Safari’s Extension Builder tool will create a .safariextz file that you can host on your web server. You may also submit the extension for inclusion in Apple’s Safari Extension Gallery, providing users with a one-click installation experience. Users can then install the extension in either of the following ways:

Putting Your Extension on a Web Server

To make your extension available via a web server:

  1. Build and sign the extension in Extension Builder to create a .safariextz file.

  2. Include a link to a copy of your .safariextz folder on your website. Be sure to include a description of what your extension does.

  3. Make sure your web server is serving the extension using the MIME type application/octet-stream.

    Most web servers maintain a table of file extensions and MIME types, and provide an administrative tool for updating the table. For example, to add a MIME type to an Apache web server, use the AddType directive:

    AddType application/octet-stream .safariextz

    For IIS web servers, the MIME settings are typically accessed using the MMC by right-clicking the host computer name and choosing Properties, then adding a new MIME setting and file extension.

For more information, consult the vendor’s documentation for your web server, or do a web search for “add MIME type” + YourWebServer + YourVersionNumber.

Submitting Your Extension to the Safari Extensions Gallery

To submit your extension to the Safari Extensions Gallery:

  1. Post the extension on your web server with the MIME type for .safariextz files set to application/octet-stream, as described above.

  2. Go to developer.apple.com and log in as a Safari Developer.

  3. Sign your extension with your Safari Extension Signing Certificate.

  4. Click through the Safari Extensions Gallery Submission Agreement.

  5. Enter the details about your extension in the Safari Extensions Gallery Submission form and click Submit.