Introduction
You can connect your Discogs account in order to manage multiple tasks with Common Ground:
Fetch release information from the Discogs database
Import listings from your Discogs Inventory into Common Ground
Publish listings on your Discogs marketplace from Common Ground
Import orders from Discogs into Common Ground and manage your orders from Common Ground directly
Connect your Discogs account with Common Ground
To connect your Discogs account with Common Ground and link release data, synchronize listings and manage sales:
Go to Preferences > External Services and select Connect my Discogs Account.
Follow the prompts and authorize Common Ground to access your Discogs account.
Preferences
Connect a Discogs account:
Connect a Discogs account to link release data, synchronize listings and manage sales.
Synchronize the stock and import orders from Discogs:
Allow Common Ground to manage your Discogs listings and sales
Generate daily discrepancy reports:
Allow Common Ground to send you daily discrepancy reports about unsynced listings.
Exclude / Include taxes:
Listing price published to Discogs is Price before / incl. sales tax.
Refer to your tax preferences for more details.
Percentage to add to Discogs listing price:
With this option, listings that are generated on Common Ground but synced to Discogs will see a percentage added to them when they appear on the Discogs marketplace.
Discogs synchronization guidelines
When using synchronization there are some important things to keep in mind to avoid inconsistencies in your inventory and sales data.
Do ✅ | Do Not ❌ |
Add releases on Common Ground -> ‘List to Discogs’ from Common Ground | List on Discogs |
Unlist from Common Ground | Delete listings on Discogs |
Edit listings on Common Ground | Edit listings on Discogs |
If you do happen to list an item directly on Discogs, use the following link to manage any non-synchronized listings between Discogs and Common Ground.
Common Ground → Discogs API
The Discogs API has limitations, and managing Discogs orders from the Common Ground Backoffice is different from managing them directly on Discogs.
Some of these limitations concern the amount of requests we can send to their API, as we cannot exceed one request per second. Therefore, we have configured our systems as follows:
We only scan for new orders on your Discogs profile every 30 minutes.
We only scan the last 20 orders on your Discogs profile.
We only update orders that are beyond the last 20 orders when you open the order page on CG.
We cannot import messages that aren't in an order.
We do not support merged orders through Discogs.
Items will be hidden on Discogs market place if they are sold out from your backoffice
Auto-Cancelled orders (non-paying buyer): items must be manually re-listed
Note: Common Ground does not support importing of orders that are Merged on Discogs.
Identify Stock Discrepancies
Discrepancies in stock may occur from time to time due to these limitations, although they are rare if you follow the guidelines.
To ensure your inventories are in good standing and to reconcile any unsynced listings, understand how to use the Discogs Discrepancy Report tool :
Another way to ensure listings are properly synced is to verify that the correct ID numbers match between Discogs and Common Ground:
Discogs release ID number
Discogs Release ID number seen from Common Ground Release page
Orders containing unsynced listings cannot be imported and will trigger a Discogs Import Error:
Discogs Import Error : Not enough stock or listing not found for release:
Import my Discogs Marketplace inventory
If you already have inventory listed on Discogs, you can import it directly using our Discogs Inventory Importer : Inventory > My Discogs Inventory.
In this menu you will see your Discogs inventory and options for each item.
Import and synchronize all Discogs listings : Import All
Import individual listings to inventory: Import to inventory
Unlist items from Discogs : Unlist from Discogs
Keep in mind that in the current version, there is no option to unlist / delete listings in bulk. So it's a good idea to tidy up your Discogs inventory before you import it.