The Grantee System

To give access to functionality in your product, you create a subscription for one of your plans and assign its seat to a grantee.

A grantee is a unique string of characters used to identify an entity. It could be a user, an organisation, a Trello board, a Miro team; if it can be uniquely identified in some way, a license can belong to it.

The grantee can technically be any set of characters but we'd recommend it meets the following criteria:

1. It should uniquely identify the entity that should have access to the subscription's plan.
2. It should be an identifier that won't change.
3. It shouldn't contain any commas. Salable uses commas to separate grantees in a list.

A subscription seat can be re-assigned at any point , to a completely different grantee.

Because the grantee is a simple string, you can join together any combination of values to represent the entity that the subscription seat belongs to. For example, if you want a subscription to belong to a specific user on a specific Trello board, you could make the grantee something like the following: board_PxEQPoMz user_19282.

You’ve got unlimited options, what you assign your seats too will really come down to your business model and how you plan to monetise your application.

Now go and build something great.

The Salable Team