The OAR Embedded Map
Looking to display your supplier list on your website as a customized map?
The Open Apparel Registry offers an easy-to-use embedded map for your website so that your users can easily interact with the data, but you don't have to go through the process of building and designing it yourself.
How it Works
By subscribing to this feature, you’ll be able to simply upload your data to the OAR and then pull just your organization’s data into a supplier map on your website. You can even include additional data points not hosted on the OAR, such as gender break-downs of workers, social/environmental improvement programs, and more.
Use the OAR Embedded Map to:
Save money and time: eliminate the need to build a custom supplier map for your website from scratch. The intuitive management interface means that your data can be refreshed with minimal to no involvement from your IT team (dependent on your company’s site access and management permissions).
Streamline future data updates: refreshing your supply chain data on the OAR will automatically update on your custom website.
Demonstrate your commitment to opening up supply chain data: join the growing movement for open data and transparency in the apparel sector. People are increasingly looking for more information about where and how clothing is being made. Hosting a supply chain map on your website is a simple, visual way to provide your site visitors with that information.
Embed a searchable, responsive map on your site, pulling your organization’s data directly from the OAR
List data points included in the OAR (facility name, address, number of workers, parent company, type of product, type of processing, and type of facility), as well as custom data points of your choosing
Customize colors and fonts to match your brand
There are a range of embedded map pricing packages to meet your needs (prices are in US dollars).
Looking for custom functionality for your map, not outlined in the chart above? Contact our team.
If you would like to sign up for one of the above Embedded Map packages, please complete the following steps:
- Create a free account on the OAR, if you don’t already have one.
- Complete this short form, letting us know which pricing package you desire. A member of the OAR team will contact you to share invoicing details (as applicable) and subsequently grant access to the plug-in.
Once you've completed the sign up process, it's fast and easy to configure your map. Watch this quick video to see how it works:
If you have any additional questions or would like to set up a live demo, please contact our team.
Frequently Asked Questions
1. Upload spreadsheet(s) of your supplier data (including any additional data points you would like to display on your embedded map) to the OAR. You’ll need to register for an account, if you have not already done so. If you have an OAR API integration, your embedded map data will automatically pull from there.
2. Navigate to your OAR Settings menu and then select Embed.
3. In the Embed tab of your OAR Settings, customize your map’s data points, branding, and size (you’ll be able to see a map preview as you work).
4. Copy the automatically generated code, containing your embedded map settings, and add the code to your website.
1. Update your data in the OAR and see the updates on your embedded map. Note: all changes are made in OAR. There is no option for editing the data directly in the embedded map.
2. As needed, adjust the data fields, branding, and size of your map in the OAR Embed Settings to generate updated code to add to your site.
The OAR Embedded Map is added to your site as a raw iframe tag, so your website must be using a CMS that supports adding raw iframe tags (most do!).
Here are a couple of items for your tech team to consider:
The Embedded Map is added to your site as a raw iframe tag, so your website must be using a CMS that supports adding raw iframe tags in order to use the Embedded Map.
One of the configurable settings for the Embedded Map is the map size. You can choose a specific pixel height and width, or you can set the width to 100%, which will automatically take up the full width of your page, and then you can choose the corresponding height. If you select 100% width, you will not have additional padding on the sides of your Embedded Map, which could affect the user experience while scrolling on the page. We recommend thoroughly testing on multiple devices and screen sizes if using the 100% width feature.
All active, public lists associated with your Contributor account on the OAR will be pulled into your Embedded Map. If you have one active, public list, it will use that. If you have multiple active, public lists, it will pull all of them and users will be able to filter by list on the map itself.
The answer to this question will depend on the OAR Embedded Map package that you choose. All Embedded Map packages allow you to add the five additional data points available in the OAR. Embed Deluxe includes those fields and unlimited additional data points. Those data points could include (but are not limited to):
- % female workers
- % migrant workers
- Unionization / worker representation at facility
- % capacity utilization
- Length of relationship with facility
- Responsible sourcing / audit results
- Social / environmental improvement programme
- Water use
- GHG emissions
We won’t put an exact number on it, as every organization and person is different, but once you have adjusted your embedded map data and settings to your requirements, adding it to your website is as simple as copying and pasting the code for the embedded map onto the back-end of your website.
It depends. Changes to your data fields or styling will not require a code update, as that data is stored in the OAR database, rather than in the code itself. Changes to the size of your map will require copying your updated Embed code to your website. Should you wish to adjust your Embed size settings after you’ve set up your map, you will need to make those adjustments in the Embed tab of the OAR, copy your new Embed code, and then replace your old code on your website.
No. The Embedded Map will not display additional contributor information for your facilities. If users wish to view this information, they will need to visit the Open Apparel Registry directly.
Nope! While the facility profile on OAR includes links to claim a facility or to suggest a data edit, those links are not included on the embedded map version. People will be able to search and view your facilities on the Embedded Map, but they will not be able to contribute suggestions or data that you need to review.
Because of the way the Embedded Map is designed, it is essentially loading a new page inside your current website. This means it is not actually loading any content directly into your website that could disrupt the surrounding page or other pages. From a technical perspective, the OAR cannot see any data or content on the surrounding page.
The content on your Embedded Map is being pulled directly from the data that has been contributed through your profile on the Open Apparel Registry. You are able to update that data yourself as often as you wish - including removing facilities you are no longer working with.