> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/application-management/packages/package-store/package-store-details.md).

# Subscribing to a Package

Subscribe to a RealmJoin Package Store package as managed or basic, for deployment via the RealmJoin Agent or Intune, and configure its name, description and category.

{% embed url="<https://www.youtube.com/watch?v=QYBx9yto560>" %}
Video tutorial
{% endembed %}

Subscribing adds a package from the [Package Store](https://docs.realmjoin.com/application-management/packages/package-store.md) to your tenant. Afterwards it appears in [Package Management](https://docs.realmjoin.com/application-management/packages/package-management.md) and can be [assigned](https://docs.realmjoin.com/application-management/packages/package-deployment.md) to users and devices.

{% hint style="info" %}
No license is acquired with the subscription. You are solely responsible for any licensing agreements with the vendor of the software.
{% endhint %}

## Choose deployment method and subscription type

<figure><img src="https://2868468309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FBhHNY7oIIdRlbpCkgHCL%2Fimage.png?alt=media&amp;token=d5a1a5d8-2fcb-4b7b-92b4-bd5755ab4b84" alt=""><figcaption><p>Subscribe buttons</p></figcaption></figure>

The **Subscribe** section on the Overview tab of a store entry offers up to four buttons, depending on the deployment methods enabled for your tenant:

* **Use RealmJoin (managed)** - recommended
* **Use RealmJoin (basic)**
* **Use Intune (managed)**
* **Use Intune (basic)**

The first part decides the [deployment method](https://docs.realmjoin.com/application-management/deployment-methods.md): the RealmJoin Agent or an `intunewin` app in Intune. The second part decides the subscription type: **managed** packages come with RealmJoin-managed Entra ID groups, **basic** packages are assigned manually. See [Managed and basic subscriptions](https://docs.realmjoin.com/application-management/packages.md#managed-and-basic-subscriptions).

If no button is shown, no deployment method is enabled for this package in your tenant. Please contact support to subscribe to it.

## Configure the subscription

{% stepper %}
{% step %}

### Review the package

The button opens a preview of the package as it will appear in your tenant. Craft packages show the [suffix](#craft-packages-suffix) here.
{% endstep %}

{% step %}

### Click Continue

The dialog **Please configure the app subscription** opens.
{% endstep %}

{% step %}

### Adjust the settings and submit

<figure><img src="https://2868468309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FUbMyhaWZTiNDWbiu4Lve%2Fimage.png?alt=media&amp;token=fb52df67-bd5a-4703-9749-f49dced78d20" alt=""><figcaption><p>Configuring the category/group name during subscription</p></figcaption></figure>

* **App display name** - The name under which the app appears to users, up to 120 characters. It must be unique among your RealmJoin and Intune apps; if the name is already taken, the dialog links the existing app.
* **Short description** - RealmJoin deployment only. The description users see in the [App Catalog](https://docs.realmjoin.com/realmjoin-agent/client-menu/self-service-portal.md#app-catalog-tab), up to 1000 characters. The field is prefilled with the package's description; replace it with a text that tells your users what the package is for. Only a changed text is stored as a custom description. You can change or reset it later on the [package details page](https://docs.realmjoin.com/application-management/packages/package-details.md#short-description).
* **Group name** (RealmJoin) - The category under which the app appears in the RealmJoin Tray menu. The App Catalog's category filter uses it as well.
* **Categories** (Intune) - One or more categories under which the app appears in Intune and the Company Portal.

App display name and short description require the `CanEditAppDisplayName` [permission](https://docs.realmjoin.com/administration-and-settings/permission/custom-roles/available-permissions.md). Group name and categories are only shown if your tenant has app categories.

Click **Submit** to start the subscription. The page shows the progress until the package is created in your tenant.
{% endstep %}
{% endstepper %}

<figure><img src="https://2868468309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-bf66cf24dfcdd728d20cb2f73c47db1b2fb0b48a%2Fapp-subscription-short-description.png?alt=media" alt="App subscription dialog with short description field"><figcaption><p>Short description in the app subscription dialog</p></figcaption></figure>

### App categories

The available categories are managed under **Settings** > **App Categories** (see [App Categories](https://docs.realmjoin.com/administration-and-settings/app-categories.md)). The same list is used for the RealmJoin group name and the Intune categories.

<figure><img src="https://2868468309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-e58b4e4a5a59b096b7a3015b5ff742c91ce3332a%2Fsettings-app-categories.png?alt=media" alt="App Categories tab in the RealmJoin Portal settings"><figcaption><p>All categories available in the tenant</p></figcaption></figure>

You can change the category later in the package's [Expert Settings](https://docs.realmjoin.com/application-management/packages/package-settings.md#expert-settings).

## Multiple subscriptions of one package

### Craft packages (suffix)

Craft packages are often used for configurations such as printer or network drive mappings, which need to be subscribed and assigned multiple times. Because RealmJoin accepts every package ID only once, each subscription of a craft package gets a suffix that turns the ID `this-id` into `this-id#suffix`.

If you do not set a suffix, a random one is used and the page shows the resulting ID. To choose your own suffix, click **Set suffix** before continuing. A suffix may contain letters, digits, `-` and `_`.

<figure><img src="https://2868468309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2F4sW7kurSWKVJMOfPzVDP%2Fimage.png?alt=media&amp;token=8d946dcb-65f9-48cc-8922-049ddaf41d18" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
The suffix is only available for RealmJoin deployment.
{% endhint %}

### Choco and Intune packages

If you need multiple configurations of an application, e.g. "Microsoft 365 Apps for Enterprise" in different languages, subscribe to it multiple times and give each subscription its own **App display name**, e.g. "Microsoft 365 Apps for Enterprise - DE". The name is reflected in the managed groups RealmJoin creates.

{% hint style="danger" %}
Suffixes are not available for these packages. Subscriptions of the same Chocolatey or `intunewin` package share the same identifier, so a user can only have one of them installed at a time. Do not assign multiple subscriptions of the same package to the same user; this results in conflicts and is not supported.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/application-management/packages/package-store/package-store-details.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
