Promo codes are an alternative to user accounts in your library. If you would like to avoid the hassle of user emails, notifications, and password reset links, promo codes are definitely your choice. Instead of having users sign in with an email and password, they can sign in with a single code. Just like with users, promo codes only apply to private libraries. Public libraries by definition allow for anyone to access its books.


Under the Manage tab, click on the Hosted Libraries item in the left column. Select your library from the dropdown list. For library management, you will spend most of your time on this part of Kotobee Author.


Select Promo codes from the left column under Hosted Libraries. You will see a listing of all the promo codes in your system. 

Library permissions

Depending on the library permission settings, you can choose to show or hide unauthorized books from the promo code. The permission settings will control the view that is given to the promo code. It is worth first going through the Adjusting your library settings article before continuing this one.

Scopes of permission

With Kotobee Library, there are three scopes of permission that you can give a code. Firstly, you can give global access to the library. With this scope, the promo code has access over all books in the library, and future books uploaded to the library. The next scope is category permissions. The promo code here is assigned permissions to access all books that are under a certain category/genre. This can be used smartly, to have a category named "free", then another category named "basic", and then a third one named "premium". Each category can hold a number of books. Depending on your user's payment, you can give him permission to one of those categories. It is worth mentioning that you may hide the category name from the Customize subsection. The final scope is book permissions, where the promo code is given access to a particular book.

Creating promo codes

When creating a new promo code, it is particularly important to be aware of what scope of permission it is given. There are two ways to control permission scope. The first way is by being inside the scope of a certain entity before creating the code. Elaborating further, to give global access, simply click on the Promo codes subsection. To give category access, click on the Categories subsection, and click Promo codes next to the appropriate category. To give book access, click on the Books subsection and under the appropriate book, click on Promo codes. All three actions will take you to the Promo codes subsection, but in different scopes. You should realize at the top title of the subsection, whether it says Registered Promo Codes, or a book name, or a category name. The second way to control promo code's permission scope happens after creating the promo code, by clicking on its Permissions button (explained later).

To create a new promo code for this permission scope, click the Create code button (in the case of global access, the button will be + Create global code). You will see a new random code added to the list. The code user cannot access the library unless the code is activated. Beside the code itself, you will find a number of additional options to choose from:.



Immediately activate the code.


Display the list of devices authorized to access the ebook (read below).


Edit the code's permissions to books, categories, or the entire library.

Mark as used/unused

Mark the code as being used or unused. This does not do any other effect but highlight the code's row in green. It's useful to avoid losing track of what is being used and what note

Create similar

Replicate the code to another random code, but using all the same permissions. You will be given the choice to enter the number of replicates you want to create.


Deletes the code. This button only appears under the All Codes list.

Remove access

Remove access to the current scope. This button only appears under the Global Codes or Codes with Access lists


Editing code's permissions

Click on the code's Permissions button to view the list of current permissions allowed. Permission scopes will be highlighted in different colors. You may delete any of the current permissions from the list. To add global access to the library, click on the Add global access over library button. To add access to a certain book or category, simply type in the first few letters in the relevant fields, and select the book or category from the appearing list.




Adding code permissions

Another way to add code permissions is by going to the appropriate scope's code listing (i.e. clicking on Promo codes for a certain book or category), then clicking the dropdown arrow next to the Create code button. Select Add code permissions. In the appeared dialog box, type in the promo code you would like to add the scope permissions to. The textfield will autocomplete by typing just the first few letters of the code. Click OK.


Device DRM

In the case of private libraries, you can limit the number of devices that can access the library, using Kotobe's Device DRM, which can 

be set from the library Settings subsection. When clicking on Devices for any user, you will see the different devices used to connect to the library. If the user complains that he had replaced his device, you can simply click on Clear all devices to reset the list for him.


By clicking on the Dashboard button you will be able to open all information on that promo code from one screen.