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 10, 2024
2 parents 4e8374e + 48c109f commit 76a7ebd
Show file tree
Hide file tree
Showing 3 changed files with 28 additions and 38 deletions.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
35 changes: 16 additions & 19 deletions content/guides/applications/integrations/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,11 +14,11 @@ alias_paths:

# Integrations

The [Box Integrations][app-center] is the first place for Box users to find out
about applications that they can use in combination with Box. If your
application is suited to be used by other enterprises, listing your service in
the Integrations can be a great way to find new users.
Integrations groups apps into sections so that you can
[Box Integrations][app-center] is the first place for Box users to find out
about applications they can use in combination with Box. If your
application can be user by other enterprises, listing your service in
under **Integrations** can be a great way to find new users.
Integrations group apps into sections so that you can
quickly find featured, most popular, or recently added apps.

![Integrations](./images/box-integrations.png)
Expand All @@ -36,29 +36,26 @@ Use the following steps to publish an application in Box Integrations.
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 the Integrations does not support any other authentication methods.
* The application leverages OAuth 2.0 authentication, as Integrations do not support any other authentication methods.
* You are a developer with access to the application in the [Developer Console][devconsole].

### Steps

1. Navigate to the [Developer Console][devconsole] and select your application to submit.
1. Navigate to the [Developer Console][devconsole] > **My Platform Apps** and select the application you want to publish.
2. Select the **Publishing** tab from the top menu.

![Integrations panel](./images/publishing-app.png)
![Publishing tab for an application](./images/publishing-app.png)

3. Fill in the form with your application's categories, a short and a long description, screenshots and an app icon.
4. Click **Preview** to see a preview of your application listing.
5. Finally, submit the application for approval by clicking the **Submit for Approval** button.
3. Read through the submission checklist and check the confirmation checkbox if your application meets all the requirements.
4. Fill in the form by providing:

<Message>
# Approval completion
* the categories your application falls under
* a short and a long description
* screenshots and an app icon
* supplementary information that will be used to support the users

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, please email [`integrate@box.com`][email] or submit a
support ticket.
</Message>
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 [`integrate@box.com`][email] or submit a support ticket.

## Unpublishing an application

Expand Down
31 changes: 12 additions & 19 deletions content/guides/getting-started/publish-app.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,28 +21,21 @@ To publish your app:

1. Open the **Dev Console**.
2. Select the application you want to publish.
3. Go to the **Integrations** tab and submit your app.
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:

This action gives you access to the marketing section of the
application, 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,
- **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.

- **General App Info** - choose correct categories and platforms for your application to make it easier to find in the Integrations,
- **App Description** - make sure it contains all information about your application 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.
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.

<Message type='notice'>

Specific guidelines for screenshots and logos are provided in the Dev
Console.

</Message>

When you're finished with providing the details about your app,
submit your app for approval. Box will review your application
and publish it in the Integrations.

In case of any questions or issues, contact the Partners team:
If you have any questions or issues, contact the **Partners** team:
[`integrate@box.com`][email]

[integrations]: https://cloud.app.box.com/integrations
Expand Down

0 comments on commit 76a7ebd

Please sign in to comment.