---
schema_version: "1"
id: 52ff518806475cbacf4e15cb762355a9540d57a5d58e315b45ed7a7b18ff70be
title: Edit auto-install.json
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/analytics/bi_dev_guide_wave_templates/guides/concept/bi-templatesdev-edit-auto-install-json.md
canonical_url: https://developer.salesforce.com/docs/analytics/bi-dev-guide-wave-templates/guide/bi-templatesdev-edit-auto-install-json.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: eb04856d6898c1a895d2160fe6f4996dc6305927d89e0d015e917592e89f2412
products:
  - Analytics Templates Developer Guide
  - analytics
---

# Edit auto-install.json

`auto-install.json` configures the template for the auto-install framework. Always create this optional file if you plan to design your template for auto-installation via a managed package with an auto-install request.

Template developers use this file to specify the configuration of the auto-install framework hook and the app installation. When this file is created, add the `autoInstallDefinition` attribute to the `template-info.json` file.

## Example

```nolang
{
  "hooks": [
    {
      "type" : "PackageInstall",
      "requestName" : "Hook for the Auto-Install Template"
    }
  ],
  "configuration" : {
    "appConfiguration" :{
      "failOnDuplicateNames" : false,
      "autoShareWithLicensedUsers" : true,
      "autoShareWithOriginator" : true,
      "deleteAppOnConstructionFailure" : true,
      "values" : {
        "value1" : "testString",
        "value2" : false
      }
    }
  }
}

```

The example creates an auto-install hook to install the template via a managed package, naming the auto-install request `Hook for the Auto-Install Template`. The supported auto-install hooks are `PackageInstall` only.

The `appConfiguration` specifies that the installed app will:

- not fail creation if an app or assets exist with the same developer name
- be automatically shared with appropriately licensed users
- be automatically shared with the user that created the auto-install request
- be deleted if app creation fails for any reason; for create requests only, it doesn’t apply to app upgrades
- be created with the template variable values in the `values` map

**important:** Because users don’t use the CRM Analytics Studio wizard to create the app, an app `name` attribute is required. To specify the app name, add a `name` attribute in the template’s `folder.json` file.

**note:** Templates packaged for automatic install can’t be dependent templates. The creation of auto-install requests can’t guarantee dependent templates are installed in the correct order.

**See Also**

- [auto-install.json Attributes](https://developer.salesforce.com/docs/analytics/bi-dev-guide-wave-templates/reference/bi-templatesdev-auto-install-json-attributes.md)
