Links

Creators FAQ

You have questions, the Unlock community has answers! Here are answers to an ever-increasing list of FAQs seen from Unlock Protocol creators. Have a question about something that's not listed? Ask it here!

How do royalties work with Unlock Protocol?

Resale royalties are usually specified at the collection level through the platforms like OpenSea where the resale might be done (e.g. https://support.opensea.io/hc/en-us/articles/1500009575482-How-do-royalties-work-on-OpenSea-). Since the memberships are ERC721s, they automatically show up on OpenSea and other marketplace platforms pretty much as soon as they are minted (e.g. https://opensea.io/collection/eth-portland-mintgate-x-unlock).
You'll probably need to reach out to OpenSea to get royalty editing turned on for your collection, as noted in the Handling Common Issues section of this article. The article notes:
"By default, the storefront editor page (https://opensea.io/category/<CONTRACT_NAME>/edit) is accessible to the contract’s Ownable __ owner. If your contract doesn’t implement Ownable, or if it does but the owner address is not accessible, or if it’s just not working, [OpenSea] can fix that manually. Send an email to [email protected] introducing yourself, providing the contract address, and providing the address that you’d like authorized to edit the storefront. OpenSea will confirm your ownership, then make the authorization."
Note: There is a great conversation with Unlock community member @littlefortunes in the Unlock Discord where she shares her experiences with setting up royalties and NFT collection information on OpenSea.

How do I set up recurring payments or automatic renewals?

Unlock supports automatic renewals & subscriptions. You can learn more here on how to implement recurring memberships and subscriptions using Unlock.

How to customize the NFT image for keys?

If you want to customize the NFT image for the keys for a lock, it can be done right through the Unlock dashboard. Here is a tutorial on how to change the image for Unlock keys.

How do I have unique images or unique rarity data for every individual key to a particular lock?

By default, all the keys to a particular lock have the same image. If you want to create unique metadata (including unique images) for keys for a particular lock, there is a great tutorial by community member Croissant on how to specify individual images and NFT metadata.

How to share ownership of an Unlock lock?

As a creator, you may want to share the ownership of your lock with other people (other creators, employees, partners... etc). For this, you should leverage the "lock manager" role. You can grant this role using a block explorer.

I want my membership price to remain stable. How can I do it?

Unlock lets you pick the price, but also the currency used by your membership. This means that you can, for example, use a stable coin such as DAI or USDC to have a price-stable in $.
Alternatively, you can change the price of your lock at any point if you need to maintain relative stability, but make sure you do not choose a highly volatile currency.
Finally, you could also leverage your lock's "hook" capabilities to alter the price of the key, but that is generally considered a lot harder to implement (and would require the help of a developer).

What are the credit card fees?

If you enable credit card payments for your lock, your members will usually be charged a higher amount than the amount for your lock. We convert the token amount using Coinbase's API and will use the resulting price to charge cards (we recommend using stable coins for credit card enabled locks). We use Stripe Connect and we add 10% of the price in order to cover the costs of Stripe, gas and our own developments costs.

Why is my lock contract not verified on the block explorer?

All of Unlock's contract are open source and should be visible. Since version 9 (January 2022), the locks are upgradable (by any of their lock managers). Unfortunately that means that block explorers like Etherscan (or equivalent on the respective chains) are not showing them as verified by default. However, verifying them is trivial. From the Dashboard, click on the block explorer icon, then click on the Contract tab, then look for the More Options button on the right of the screen and select Is this a Proxy?. Click Verify , Save and you should be good!

Can I use an existing NFT contract?

Absolutely! Unlock's PublicLock contract (the membership contract) includes a delegation mechanism that would let you point to any other on-chain contract to determine if an address is considered to be a "valid" member. Check this tutorial for more details.