Articles on: Licence keys

Assign licence keys to product

Filemonk makes it easy to assign licence keys to your products so customers automatically receive their keys when they purchase. You can choose from three assignment methods: auto-generated keys, specific tagged keys, or untagged keys from your uploaded collection.


Prerequisites and Setup


Before connecting licence keys to products, you need to have licence keys uploaded to Filemonk. If you haven't uploaded keys yet, follow the guide on adding licence keys to your account first.


Connecting Licence Keys to Products


  1. Click Digital Products in the left menu bar to access your product management dashboard
  2. Select the product that you want to link the licence key to. If you haven't added products to Filemonk yet, then follow this guide to add digital products.


Adding Licence Keys to Products


  1. Once you've selected your product and variant, Scroll down to the 'deliver these files' section
  2. Click on the 'More' button
  3. Select the 'Add licence key' option to open the licence key assignment popup



  1. The popup will display three assignment options for connecting keys to your product
  2. Choose your preferred assignment method based on your business needs
  3. Click Create to complete the setup and link the licence keys to your product



Licence Key Assignment Options

Filemonk provides three flexible methods for assigning licence keys to customer orders, each suited for different business models and key management strategies.


Auto-Generated Keys


Choose this option to have Filemonk automatically create unique licence keys for each customer order without requiring pre-uploaded keys.

  1. Select Auto-generated in the licence key assignment modal
  2. Filemonk will create and assign unique keys to orders as they come in for this product
  3. Each key is generated using a secure ULID (Universally Unique Lexicographically Sortable Identifier) format
  4. You can verify and check these auto-generated licence keys using Filemonk's API for validation purposes
  5. This option is perfect for software products that don't require pre-existing licence keys


Note: Auto-generated keys are created instantly when customers place orders, ensuring immediate delivery without manual intervention.


Specific Tag Assignment


Use this method to assign licence keys from a specific tagged group in your uploaded licence key collection.

  1. Select Specific tag in the licence key assignment modal
  2. Choose the tag from the dropdown menu that corresponds to the licence keys you want to use for this product
  3. Filemonk will automatically pick and assign keys from this tagged group when customers place orders
  4. Keys are assigned on a first-available basis from your tagged collection
  5. Once a key is assigned to a customer, it's marked as used and won't be assigned again


This option works best when you have different licence key pools for different products or software versions, allowing you to maintain organized key distribution.


No Tag Assignment


Select this option to assign licence keys from your general pool of untagged licence keys.

  1. Choose No tag in the licence key assignment modal
  2. Filemonk will pick and assign any available licence key that doesn't have a specific tag
  3. Keys are selected from your uploaded licence keys that haven't been organized with tags
  4. This method uses a first-available assignment system from your untagged key pool
  5. Ideal for simple setups where you don't need to categorize different types of licence keys


Customer Download Experience


Once licence keys are connected to products, customers will see and access their keys through the download page interface after completing their purchase.


Download Page Display


Customers receive their licence keys through a user-friendly interface that makes it easy to view and copy their keys.


  1. Customers receive an email with a download page link after purchasing your product
  2. The download page displays their licence key as a clickable button alongside any other digital files
  3. The licence key button shows custom text that you can configure (default: "Licence Key")




  1. If a licence key is not available or not yet assigned, customers see a "Not Available" message
  2. The interface clearly distinguishes licence keys from downloadable files with different styling


Licence Key Popup Display


When customers click on their licence key button, they can view and copy their assigned keys through a dedicated modal interface.


  1. Clicking the licence key button opens a modal window displaying the customer's assigned keys
  2. Each licence key is shown in large, easy-to-read text for clear visibility
  3. Customers can copy their licence keys to the clipboard using the Copy button
  4. Multiple licence keys (if applicable) are displayed in the same modal for easy access
  5. The modal title includes the order name and product information for context



Advanced Configuration Options


Licence Key Exhaustion Monitoring


Set up automatic notifications to monitor your licence key inventory and prevent stockouts.

  1. Receive email notifications when your tagged licence key pools reach specified usage levels (default: 80%)
  2. You can set this up by selecting the 'Settings' option from the left menu in the Filemonk app
  3. Next, choose 'Other' from the top menu
  4. Under Notifucations Enable 'Send email when licence keys are about to be exhausted'
  5. Set the threshold when you want to receive the email
  6. Automatic warnings help you replenish licence key stocks before running out



Error Handling and Customer Communication


Configure appropriate error messages and fallback options for licence key assignment issues.

  1. Customize the error message customers see when licence keys are unavailable
  2. To do this go to 'Settings' from the left menu in the Filemonk app
  3. Select 'download page' from the top menu
  4. Click on 'customize download page'
  5. Choose the 'Licence Keys' option
  6. Customize the different options to control what it looks like on the download page



Troubleshooting


Common issues with licence key assignment and their solutions to ensure smooth operation.


Symptom

Likely Cause

Fix

Customers not receiving licence keys

No keys available in selected tag or pool

Check licence key inventory and upload more keys

"Not Available" message on download page

Licence key assignment failed or pool exhausted

Verify tag selection and key availability in dashboard

Auto-generated keys not working

API configuration issue

Contact support to verify auto-generation settings

Wrong keys assigned to customers

Incorrect tag selection in product setup

Review and update tag assignment in product configuration

Customers can't copy licence keys

Browser compatibility issue

Advise customers to manually select and copy the key text


FAQs


Common questions about licence key assignment and management in Filemonk.


Q: Can I change the licence key assignment method after setting it up?

A: Yes, you can edit the licence key settings for any product by going to Digital Products, selecting the product, and clicking the licence key configuration option.


Q: What happens if I run out of licence keys in a specific tag?

A: New orders will fail to receive licence keys, and customers will see an error message. You'll receive an email notification when your key pool reaches the exhaustion threshold.


Q: Can customers receive multiple licence keys for one product?

A: Yes, if a customer orders multiple quantities of a product, they'll receive one licence key per quantity ordered.


Q: How do auto-generated keys work with software validation?

A: Auto-generated keys use ULID format and can be validated through Filemonk's API. You'll need to integrate your software with the API to verify key authenticity.


Q: Can I see which licence keys were assigned to which customers?

A: Yes, you can view licence key assignments in your order management dashboard and see which specific keys were assigned to each customer order.


Q: What happens to licence keys when orders are refunded?

A: Licence keys remain assigned to the original customer and are not automatically returned to the available pool. You can manually manage key reassignment if needed.

Updated on: 11/08/2025

Was this article helpful?

Share your feedback

Cancel

Thank you!