Skip to content

Commit

Permalink
Merge branch 'DDOC-1226-publishing' of github.com:box/developer.box.c…
Browse files Browse the repository at this point in the history
…om into staging
  • Loading branch information
bszwarc committed Dec 17, 2024
2 parents 77cf43d + 4f1c13f commit 14384ae
Show file tree
Hide file tree
Showing 2 changed files with 25 additions and 25 deletions.
24 changes: 12 additions & 12 deletions content/guides/applications/integrations/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,20 +23,20 @@ quickly find featured, most popular, or recently added apps.

![Integrations](./images/box-integrations.png)

## Developing and app or becoming a Box Partner
## Developing a platform app or becoming a Box Partner

If you need more information on developing an application for the Box Integrations or becoming a Box Partner, visit our [Box Partner Resources][bp] guides on our community site.
If you need more information on developing a platform app for the Box Integrations or becoming a Box Partner, visit our [Box Partner Resources][bp] guides on our community site.

## Publishing an app
## Publishing a platform app

Use the following steps to publish an application in Box Integrations.
Use the following steps to publish a platform app in Box Integrations.

### Prerequisites

Your application must meet the following requirements:

* The application is in a finished state and ready for production usage.
* The application leverages OAuth 2.0 authentication, as Integrations do not support any other authentication methods.
* The platform app is in a finished state and ready for production usage.
* The platform app leverages OAuth 2.0 authentication, as Integrations do not support any other authentication methods.
* You are a developer with access to the platform app in the **Developer Console**.

### Steps
Expand All @@ -54,18 +54,18 @@ Your application must meet the following requirements:
* screenshots and an app icon
* supplementary information that will be used to support the users

5. Use the **Preview** button in the top left corner to see how your application will look when listed.
6. Finally, submit the application for approval by clicking the **Submit for Approval** button. Once a request for approval is received, the Box Partner team will be notified and review your request as soon as possible. For any questions, email [`[email protected]`][email] or submit a support ticket.
5. Use the **Preview** button in the top right corner to see how your application will look when listed.
6. Finally, submit the application for approval by clicking the **Submit for Approval** button. Once a request for approval is received, the Box Partner team will be notified and review your request as soon as possible. For any questions, email [`[email protected]`][email].

## Unpublishing an application
## Unpublishing a platform app

Once approved and published, a platform app can be unpublished from the same
control panel:

1. Navigate to the **Developer Console** and select your app.
2. Select the **Integrations** panel from the left-hand sidebar.
1. Navigate to the **Developer Console** and select your platform app.
2. Select the **Publishing** tab.
3. You can now unpublish the app.

[app-center]: https://app.box.com/services
[email]: mailto:[email protected]
[bp]: https://support.box.com/hc/en-us/sections/21356597387539-Box-Partner-Programs
[bp]: https://support.box.com/hc/en-us/sections/21356597387539-Box-Partner-Programs
26 changes: 13 additions & 13 deletions content/guides/getting-started/publish-app.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,38 +2,38 @@
rank: 3
---

# Publish your application
# Publish your app

When you finish the app configuration and testing, you can publish
When you finish the platform app configuration and testing, you can publish
it in the [Box Integrations][integrations]. It allows customers to find
your application and add it to their Box accounts.
your app and add it to their Box accounts.

<Message type='warning'>

Only applications that use the OAuth 2.0 authentication have a built-in publication option. In case you use a different auth type for your integration, you can still create and publish an OAuth 2.0 platform app that will serve as a marketing listing in the **Integrations** and redirect customers to your website.
Only apps that use the OAuth 2.0 authentication have a built-in publication option. In case you use a different auth type for your integration, you can still create and publish an OAuth 2.0 platform app that will serve as a marketing listing in the **Integrations** and redirect customers to your website.

</Message>

To publish your app:
To publish your platform app:

1. Open the **Dev Console**.
2. Select the application you want to publish.
2. Select the platform app you want to publish.
3. Go to the **Publishing** tab.
4. Read through the submission checklist and check the confirmation checkbox if your application meets all the requirements.
5. The next step is the marketing section of the application, where you need to add the following app information:
4. Read through the submission checklist and check the confirmation checkbox if your app meets all the requirements.
5. The next step is the marketing section of the app, where you need to add the following app information:

- **General Info** - choose correct categories and platforms for your application to make it easier to find in the Integrations,
- **Description** - make sure it contains all information about your application that the customers may find useful,
- **General Info** - choose correct categories and platforms for your app to make it easier to find in the Integrations,
- **Description** - make sure it contains all information about your app that the customers may find useful,
- **Short Description** appears next to your app logo, together with your app name;
- **Long Description** is what the users see after they select your app to view its details. You can add clickable links to the long description.
- **Screenshots** and **Icon** - provide the screenshots to allow the users see how the app looks like and how it integrates with Box. The icon is needed to represent your app in the list of Integrations.
- **Support Resources** - A list of links and supplementary information that will help the users to work with your application.
- **Support Resources** - A list of links and supplementary information that will help the users to work with your app.

6. Before submitting your app, preview it to see if you included all the necessary information.
7. Submit your app for approval. Box will review your application and publish it under Integrations.
7. Submit your app for approval. Box will review your app and publish it under **Integrations**.

If you have any questions or issues, contact the **Partners** team:
[`[email protected]`][email]
[`[email protected]`][email].

[integrations]: https://cloud.app.box.com/integrations
[email]: mailto:[email protected]

0 comments on commit 14384ae

Please sign in to comment.