Learn how to adjust your library's settings in Kotobee Author.

General settings

Although your library settings will most probably be configured just once, it is essential to fully understand all of the different settings. 

  1. Go to the Manage tab. 
  2. Click on the Libraries item in the left column. 
  3. Select your library from the dropdown list. For library management, you will spend most of your time in this part of Kotobee Author.
  4. Click on Settings in the left column under Libraries. In this screen, you will see the different library settings. 
  5. If you make any changes to the settings, that you click on Save changes at the bottom of the page.

  • Library Name: This name will be used in the library header as well as other places. It will also represent your library in any outgoing emails to your users.
  • Library URL: You can use this URL as a reference page for the library. This URL will be sent in user activation emails. It does not necessarily need to be the Kotobee alias but it should preferably be your own website domain. If you are planning to export your library as offline apps, we recommend you include links to the apps in this URL. If you leave this field empty, no URL will be sent in the user activation emails.
  • Library Alias: This unique identifier will be used to construct the URL for the library. You can find the full library path by clicking on the Export item in the left column, under Libraries.
  • Library Info: This optional information will appear inside the library once the user requests more information on the library.

Book permission settings

You can choose how or what your users can read from your library by making it either Public or Private. A public library allows any user to enter and open any ebook freely. A private library puts restrictions on ebooks and only users with the appropriate permissions may access the ebooks. If you set your library to be private, additional permission options will be shown.

  • Allow browsing: Setting this option will allow users to enter the library and browse the book titles, but not open them until they are logged in.
  • Show all books: All titles in the library will be displayed. The user will only be able to access authorized books.
  • Show authorized books under 'My Books' tab: All books in the library will be displayed, but authorized books will be listed under a special 'My Books' tab.
  • Show authorized books only: Books which the user does not have access to will be hidden entirely.
  • Mark restricted books: If checked, restricted books will be marked with a special lock icon.
  • Unauthorized book redirect link: Instead of displaying a default 'Access Denied' message for a restricted book, you may display a button which once clicked would redirect the user to a custom URL of your choice. Additionally, you may customize the buttons' colors and label from under the Customize section.
  • Synchronize annotations with backend: When accessing the book from different platforms, the annotations are synchronized and shown.
  • Self-registration: The users are allowed to register themselves.
  • Request Admin approval first: Admin approves or rejects the self-registered user.
  • Device DRM: For extra measures to prevent piracy, limit the number of devices that may access the ebook for each registered user. If you will use that option, we recommend 3 devices.

Advanced settings

The following advanced settings are available for both public and private libraries.

  • Offline support: If no Internet connection is present, the app will show the user's downloaded ebooks, to read offline. Supported for mobile apps only. Changing this value requires you to re-generate the library app.
  • Enable Tin Can: Provide experimental information about the user's activity to an LRS.
  • Enable LTI: Integrate with your LTI-compliant LMS in a way such that logged in students can access your library as an External Tool and without needing to sign in. For more information, click here.
  • Reject improper cover images: If the cover image is far from proportional to a standard book cover, the submission will be rejected with an appropriate error message displayed to the user.

Promo code settings

The following settings are available for promo codes in your library.

  • Use promo codes: You may disable promo code functionality altogether by setting this option to Disable.
  • Show 'Redeem code' button in the following areas: The option to redeem codes will appear to your users only in the locations you choose.
  • Expire promo code after: If the promo code is uniquely created for a specific user, you may choose that the promo code be redeemed once, then become obsolete to avoid it falling into wrong hands. If the promo code is meant to be used by multiple users, then it should be set to never expire.
  • Login using promo code: Only shows the fields that will be used for user login. There are two methods that users may access private libraries: using an email/password combination or using promo codes. You may select which login methods you want to enable for your library. This way only the relevant fields will be shown in the app.

Email settings

An essential component of library systems is email notifications. Users should be able to receive notifications and password reset codes in their emails. The emails being sent use Kotobee's servers, with the sender being Kotobee's name and email. By default, the emails contain Kotobee's logo and signature. For branding reasons, you may prefer to have the emails sent using your name, logo, and signature in the email body. To do that, merely fill the different email settings in this section.

Note: If you wish to change the sender's email address altogether, please contact customer support for instructions.

Here are the default header and footer used in Kotobee emails, unless you want to enter your own. Feel free to copy and edit it as you wish.


<table width="100%" border="0" cellpadding="0" cellspacing="0" style="table-layout:fixed; background-color:#3a2243">
        <tr height="45px">
            <td width="100%">
                <table style="width:100%; max-width: 800px; margin: 0 auto;">
                        <td width="10px" align="center" valign="middle"></td>
                            <a href="http://www.kotobee.com" target="_blank" style="color:#e4b8ef;text-decoration:none;padding-top:5px"><img src="http://www.kotobee.com/bundles/vijualib/images/emailLogoHeader.gif" alt="Kotobee"/></a>


<div class="footer">
        <a href="http://www.kotobee.com" target="_blank"><img src="http://www.kotobee.com/bundles/vijualib/images/emailLogoFooter.gif" alt="Kotobee.com"/></a>
        <span>Learn more with: </span>
        <a href="http://www.kotobee.com/blog" target="_blank">Kotobee Blog</a> |
        <a href="https://www.linkedin.com/company/kotobee" target="_blank">LinkedIn</a> |
        <a href="https://twitter.com/kotobeeofficial" target="_blank">Twitter</a> |
        <a href="https://www.facebook.com/kotobee?ref=hl" target="_blank">Facebook</a> |
        <a href="http://support.kotobee.com" target="_blank">Knowledge Base</a>