After preparing your data, follow these step-by-step instructions to upload to OS Hub.
This is part two of three guides:
If you’ve prepared your data for OS Hub and are ready to upload it, then this guide is for you. If you haven’t prepared your data yet, check out this guide for templates and step-by-step instructions.
Logging into Open Supply Hub:
If you have an Open Supply Hub account: Log into Open Supply Hub using the credentials you set up.
If you were an Open Apparel Registry user but have not yet used OS Hub: DO NOT create a new account. Please log into OS Hub using your OAR login credentials. If you do not remember or have access to your OAR login credentials, you can use the forgot password link on the login page.
- If you are a new user and your organization has never contributed data to the OAR or Open Supply Hub: Register for a free account.
If you are not sure which email address is associated with your organization's account, please email email@example.com.
NOTE: There can only be one OS Hub account associated with a Data Contribution on OS Hub. If you think that more than one person from your team will need to access or manage your data on OS Hub, we suggest signing up with an email address accessible to multiple team members (like firstname.lastname@example.org or email@example.com).
Uploading your data:
1. Once you are logged into Open Supply Hub, click the Upload Data button in the upper right corner.
2. Enter your facility list name. If you are uploading multiple lists, ensure that your list name includes what makes this list unique from the other(s) (Tier 1, Certified Facilities, Program Name, etc). This list name will be public-facing.
3. Enter your list description. Enter a description of this facility list and include a timeframe for the list's validity. This will also be public-facing.
4. Select your CSV/Excel file. Select your prepared file to upload.
5. Select a list to replace. If you have previously uploaded a facility list through this account (even if it was in the OAR), you are able to replace that out-dated list and make it inactive through this feature. Simply select the list that your new list is replacing. (If this is your first upload, you can skip this step.)
6. Hit Submit! You did it! Your list is now submitted to the OS Hub team for approval. If you are uploading multiple lists to your account, you can now repeat this process with your next list.
If approved, you’ll receive an email once your list is processed and live in Open Supply Hub.
If your list is rejected, you will receive an email from the OS Hub team with directions on how to update your list to meet data quality standards.
Make the most of OS Hub
Once your data is live in OS Hub, there are a number of ways you can make use of it. Check out this guide for inspiration.
Q: I’ve received an email that my list has been processed, but some of my facilities are not yet showing up in my list on OS Hub. Why is that?
A: When your list is uploaded to OS Hub, an algorithm is comparing each facility in your list to the facilities already in the database. If the system is more than 80% confident that it has found an entry for one of your facilities that already exists in the database, it will match your facility to that facility profile and OS ID. If there is less than 50% confidence that there is already an existing entry for that facility, a new profile and OS ID will be created. If the system thinks it has found a match but isn’t sure (i.e. it’s between 50 and 80% confident), it asks that a human check the match. Those facilities may take a few more days to show up in your list, as the OS Hub Data team is performing that human check before publishing that facility to the database. Read more below about what’s happening behind the scenes to get your list into OS Hub.
Behind the scenes: what’s happening to your data when you upload
Open Supply Hub is an open data platform. This means that any organization with supply chain data is able to submit it to the database. However, this does not mean that all data is automatically and immediately published. We are constantly working to maintain a balance between making it easy to share data, and preserving a high level of data quality, so that the data in the tool is as useful as possible. Here are some of the steps happening behind the scenes to check your data, before it goes live:
- Step 1: The list as a whole and the account contributing that list are manually examined by the OS Hub Data team for quality and formatting. Your list will either be accepted to move to the next stage, or rejected, with tips for how to update your data.
Go to My Lists to check your list status.
- Step 2: Once a list is accepted, then each facility is processed individually by statistical model on which OS Hub is built. The platform is checking to be sure the system can read and map the data submitted, and then whether the facility matches an existing facility already in that database (check out the FAQ above for more info on that step). If there is an issue that prevents a facility from moving through this process, it will move into an “Error” state and will not appear in your public-facing list on Open Supply Hub. If your list generates a large number of errors, the OS Hub team will reach out to you to help you update and resolve them. Check out our FAQs for more information about Errors and how to resolve them.
Click on your list to see and filter the stages each of your facilities are in.
NOTE: If you uploaded fields beyond country, name and address, they will not appear in this view, even if they are being processed. You’ll be able to access and download them through your public-facing list on opensupplyhub.org.