Skip to main content

Publish a service definition

A service definition is a portable file that contains all the information needed to publish an item, such as its properties, capabilities, and service type. It can be used to publish feature layers, tile layers, map image layers, imagery layers, locators, web tools, geodata services, and knowledge graph layers. If you have a service definition file that you want to add as an item or publish, you can do so from the portal.

To publish a service definition, complete the following steps:

  1. Verify that you are signed in to your organization and that you have privileges to create, update, and delete content.

    If you are publishing a web tool service definition, you must be an administrator or have the privilege to publish web tools.

  2. Open Content > My content and click New item.

  3. Click Your device, browse to the location of the service definition (.sd) file on your local machine or a directory on a network share, and click Open.

    Alternatively, drag the file into the drop zone at the top of the New item window.

  4. Choose Add <file name> and create a layer and click Next.

    If, instead, you add the file but don't publish the item, you can publish later from the service definition file's item page.

  5. Continue with one of the following workflows, depending on the item type:

Publish a hosted item

Use this workflow to publish a hosted item, such as a hosted feature layer, hosted tile layer, hosted imagery layer, and knowledge graph layer.

  1. Review the item information and update it as needed:

    • Name—This option is only available for knowledge graph layers. By default, the name reflects what is provided in the service definition file. Updating the name for a knowledge graph layer also updates the name of its underlying service. You can update the names of other hosted items after they are added to the organization.

    • Folder—Choose a folder in My content where you want to save the item. To create a folder, choose Create new folder from the menu and provide a folder name.

    • Tags—Provide tags that describe the item. Separate terms with commas (for example, Federal land is considered one tag, and Federal, land is considered two tags). As you type, you can choose from suggested tags generated from tags you previously added.

    • Summary—Provide a summary that describes the item.

  2. Click Save.

By default, only item owners and administrators can access the layer. To allow others to access it, share the layer and file with everyone (the public), your organization, or members of specific groups. You can edit the item details and change the item settings.

Publish an item that uses registered data

Use this workflow the publish an item that uses registered data, such as a feature layer, map image layer, locator, web tool, or geodata service.

  1. Review the name and location information and update them as needed:

    • Name—By default, the name reflects what is provided in the service definition file.

    • Portal folder—Choose an existing folder or create a new folder in which to store the item.

    • Server and folder—Select a server, then choose an existing or create a new folder to publish the service to.

      Tip:

      If you are unable to select a server, click Information next to the server for relevant details.

  2. Click Next.

  3. Ensure that the applicable capabilities and extensions are enabled on the service.

    By default, the enabled capabilities and extensions reflect those that were enabled when the service definition file was created. To enable additional capabilities or extensions, ensure that they are supported by the source data.

  4. Click Next.

  5. Review the item details and update them as needed:

    • Tags—Provide tags that describe the item. Separate terms with commas (for example, Federal land is considered one tag, and Federal, land is considered two tags). As you type, you can choose from suggested tags generated from tags you previously added.

    • Summary—Provide a summary that describes the item.

  6. Click Save.

By default, only item owners and administrators can access the layer. To allow others to access it, share the layer and file with everyone (the public), your organization, or members of specific groups. You can edit the item details and change the item settings.