Help center home/MapBuilder/Step by step instructions/Adjust MapBuilder configuration settings
Search the GFW help center
Last updated {date}

Global Forest Watch Help Center

https://www.globalforestwatch.org/help

Adjust MapBuilder configuration settings

MapBuilder offers several ways to customize an application. Below is information on how to adjust general settings, alternative language settings, data layer and analysis settings, and other settings on your MapBuilder application. This information will enable you to customize the application template by changing specific properties within the application’s code.

Learn how to do more advanced customizations on GitHub here.

Adjust general settings

The general settings allow you to customize items such as the application text, logos, hyperlinks and the web map. These items are the general attributes of the map that you can directly edit using the code. Learn more about these general attributes on GitHub here.

PropertyExplanationData typeExample
Web mapWeb map ID from ArcGIS Online to use in the application.String“webmap”: “de85e3fcc07948238aa6c1afd2a4eb0”,
LanguageIdentifies the language for the application.String“language”: “en”,
TitleTitle for the application.String“title”: “GFW MapBuilder”,
SubtitleSubtitle for the application.String“subtitle”: “Make maps that matter”,
NarrativeShort description that will be visible in the information tab of the application. Use html tags to edit and customize the formatting of this text.String“narrative”: “This MapBuilder provides an overview of land use in the DRC”,
webmapMenuNameHeading on the menu for a group of data layers that are pulled from the web map.String“webmapMenuName”: “Land Use”,
logoURLURL for an image of your logo.String“logoUrl”: “http://my.gfw-mapbuilder.org/img/gfw-logo.png”,
logolinkURLURL for the website your application will link to when your logo is clicked.String“logoLinkUrl”: “http://globalforestwatch.org/mapbuilder/”,
aboutLinkUrl (optional)Adds an “about” menu item in the header. The link will point to the given URL.String“aboutLinkUrl”: “http://wri.org”,
downloadLinkUrl (optional)Adds a “download” menu item in the header. Link will point to the given URL. This is useful for linking to an open data portal.String“aboutLinkUrl”: “http://wri.org”,
“downloadLinkUrl”: “http://wri.org”,
customColorThemeCustomize the color theme for your application.String“customColorTheme”: “#F0AB00”,

Adjust alternative language settings

Alternative language settings allow you to specify a secondary or alternative language for your MapBuilder application. You can also provide a translated map, title, subtitle, narrative and web map menu name. These settings are only needed if you want to translate your MapBuilder application.

Below are the languages that MapBuilder currently supports.

  • English (en)
  • French (fr)
  • Spanish (es)
  • Portuguese (pt)
  • Indonesian (id)
  • Chinese (zh)
  • Georgian (ka)
PropertyExplanationData typeExample
useAlternativeLanguage (optional)If true, then application will be translated into another language.Boolean (true or false)“useAlternativeLanguage”: false,
alternativeWebmap (optional)Web map ID from ArcGIS Online to use in alternative language.Text“webmap”: “de85e3fcc0798238aa6c1afd2a4ceb0”,
alternativeLanguage (optional)Identifies alternative language for the application.Text“language”: “en”,
alternativeLanguageTitle (optional)Title for the application in alternative language.Text“title”: “GFW MapBuilder”,
alternativeLanguageSubtitle (optional)Subtitle for application in alternative language.String“subtitle”: “Make maps that matter”,
alternativeNarrative (optional)Short description that will be visible in the information tab of the application in alternative language. Use html tags to edit and customize the formatting of this text.String“narrative”: “This MapBuilder provides an overview of land use in the DRC”,
alternativeWebmapMenuName (optional)Heading on the menu for a group of data layers that are pulled from the web map in alternative language.String“webmapMenuName”: “Land Use”,

Adjust data layer and analysis settings

Data layer and analysis settings allow you to add and remove data layers from GFW to your MapBuilder application. Some of the data layers from GFW are added to the MapBuilder template by default.

PropertyExplanationData typeExample
viirsFiresIf true, then the VIIRS fires data layer from NASA will be included on the map.Boolean (true or false)“viirsFires”: true,
modisFiresIf true, then the MODIS fires data layer from NASA will be included on the map.Boolean (true or false)“modisFires”: true,
intactForestsIf true, then the Intact Forests Landscapes data layer will be included on the map.Boolean (true or false)“intactForests”: true,
aboveGroundBiomassIf true, then the aboveground biomass data layer will be included on the map.Boolean (true or false)“aboveGroundBiomass”: true,
landcoverIf true, then the global land cover data layer will be included on the map.Boolean (true or false)“landcover”: true,
mangrovesIf true, then the global mangrove forest data layer will be included on the map.Boolean (true or false)“mangroves”: true,
sadAlertsIf true, then the SAD alerts data layer will be included on the map.Boolean (true or false)“sadAlerts”: true,
gladAlertsIf true, then the GLAD alerts data layer will be included on the map.Boolean (true or false)“gladAlerts”: true,
terraIAlertsIf true, then the Terra-i alerts data layer will be included on the map.Boolean (true or false)“terraIAlerts”: true,

Adjust other settings

Other settings allow for more detailed customization of your MapBuilder application, as well as the ability to connect related MapBuilder applications.

PropertyExplanationData typeExample
Iso (optional)Three letter ISO code for the country that your application focuses on. Other countries will be masked out.Text“iso”: “COD”
hideHeaderHide the application header (including logo, title and menu).Boolean (true or false)“hideHeader”: false,
hideFooterHide the application footer.Boolean (true or false)“hideFooter”: false,
includeDocumentsTabInclude documents tab on the application.Boolean (true or false)“includeDocumentsTab”: true,
mapThemeIds (optional)Link several MapBuilder applications together. Copy the ArcGIS Online application ID for another application and paste it into this field to link the applications together. If you want to add multiple IDs, separate them using a semicolon (;) and add a corresponding map theme title for each application in the map themes field.String“mapThemeIds”: “1c38ba1095fe49e3ba234bf9105c1077;c76d788b7487476bae4d09a4e933be19”,
mapThemes (optional)The map theme field is only necessary if you are connecting several applications together. The map theme indicates the title for your related applications. Make sure the themes are specified in the same order as your map theme IDs. If your application is translated, fill out the “alternativeMapThemes” field with your translated map theme titles.String“mapThemes”: “Forest Atlas of Cameroon;Forest Atlas of Equatorial Guinea”,
“alternativeMapThemes” (optional)The alternative map themes field is used to indicate the title of your related applications in the application’s secondary language. This is only necessary if you translated your application into a secondary language using the alternative language settings and are using the map themes option to connect related applications.String“mapThemes”: “Forest Atlas of Cameroon;Forest Atlas of Equatorial Guinea”,
Print this article
Last updated December 8th 2020

Global Forest Watch Help Center

https://www.globalforestwatch.org/help

Adjust MapBuilder configuration settings

MapBuilder offers several ways to customize an application. Below is information on how to adjust general settings, alternative language settings, data layer and analysis settings, and other settings on your MapBuilder application. This information will enable you to customize the application template by changing specific properties within the application’s code.

Learn how to do more advanced customizations on GitHub here.

Adjust general settings

The general settings allow you to customize items such as the application text, logos, hyperlinks and the web map. These items are the general attributes of the map that you can directly edit using the code. Learn more about these general attributes on GitHub here.

PropertyExplanationData typeExample
Web mapWeb map ID from ArcGIS Online to use in the application.String“webmap”: “de85e3fcc07948238aa6c1afd2a4eb0”,
LanguageIdentifies the language for the application.String“language”: “en”,
TitleTitle for the application.String“title”: “GFW MapBuilder”,
SubtitleSubtitle for the application.String“subtitle”: “Make maps that matter”,
NarrativeShort description that will be visible in the information tab of the application. Use html tags to edit and customize the formatting of this text.String“narrative”: “This MapBuilder provides an overview of land use in the DRC”,
webmapMenuNameHeading on the menu for a group of data layers that are pulled from the web map.String“webmapMenuName”: “Land Use”,
logoURLURL for an image of your logo.String“logoUrl”: “http://my.gfw-mapbuilder.org/img/gfw-logo.png”,
logolinkURLURL for the website your application will link to when your logo is clicked.String“logoLinkUrl”: “http://globalforestwatch.org/mapbuilder/”,
aboutLinkUrl (optional)Adds an “about” menu item in the header. The link will point to the given URL.String“aboutLinkUrl”: “http://wri.org”,
downloadLinkUrl (optional)Adds a “download” menu item in the header. Link will point to the given URL. This is useful for linking to an open data portal.String“aboutLinkUrl”: “http://wri.org”,
“downloadLinkUrl”: “http://wri.org”,
customColorThemeCustomize the color theme for your application.String“customColorTheme”: “#F0AB00”,

Adjust alternative language settings

Alternative language settings allow you to specify a secondary or alternative language for your MapBuilder application. You can also provide a translated map, title, subtitle, narrative and web map menu name. These settings are only needed if you want to translate your MapBuilder application.

Below are the languages that MapBuilder currently supports.

  • English (en)
  • French (fr)
  • Spanish (es)
  • Portuguese (pt)
  • Indonesian (id)
  • Chinese (zh)
  • Georgian (ka)
PropertyExplanationData typeExample
useAlternativeLanguage (optional)If true, then application will be translated into another language.Boolean (true or false)“useAlternativeLanguage”: false,
alternativeWebmap (optional)Web map ID from ArcGIS Online to use in alternative language.Text“webmap”: “de85e3fcc0798238aa6c1afd2a4ceb0”,
alternativeLanguage (optional)Identifies alternative language for the application.Text“language”: “en”,
alternativeLanguageTitle (optional)Title for the application in alternative language.Text“title”: “GFW MapBuilder”,
alternativeLanguageSubtitle (optional)Subtitle for application in alternative language.String“subtitle”: “Make maps that matter”,
alternativeNarrative (optional)Short description that will be visible in the information tab of the application in alternative language. Use html tags to edit and customize the formatting of this text.String“narrative”: “This MapBuilder provides an overview of land use in the DRC”,
alternativeWebmapMenuName (optional)Heading on the menu for a group of data layers that are pulled from the web map in alternative language.String“webmapMenuName”: “Land Use”,

Adjust data layer and analysis settings

Data layer and analysis settings allow you to add and remove data layers from GFW to your MapBuilder application. Some of the data layers from GFW are added to the MapBuilder template by default.

PropertyExplanationData typeExample
viirsFiresIf true, then the VIIRS fires data layer from NASA will be included on the map.Boolean (true or false)“viirsFires”: true,
modisFiresIf true, then the MODIS fires data layer from NASA will be included on the map.Boolean (true or false)“modisFires”: true,
intactForestsIf true, then the Intact Forests Landscapes data layer will be included on the map.Boolean (true or false)“intactForests”: true,
aboveGroundBiomassIf true, then the aboveground biomass data layer will be included on the map.Boolean (true or false)“aboveGroundBiomass”: true,
landcoverIf true, then the global land cover data layer will be included on the map.Boolean (true or false)“landcover”: true,
mangrovesIf true, then the global mangrove forest data layer will be included on the map.Boolean (true or false)“mangroves”: true,
sadAlertsIf true, then the SAD alerts data layer will be included on the map.Boolean (true or false)“sadAlerts”: true,
gladAlertsIf true, then the GLAD alerts data layer will be included on the map.Boolean (true or false)“gladAlerts”: true,
terraIAlertsIf true, then the Terra-i alerts data layer will be included on the map.Boolean (true or false)“terraIAlerts”: true,

Adjust other settings

Other settings allow for more detailed customization of your MapBuilder application, as well as the ability to connect related MapBuilder applications.

PropertyExplanationData typeExample
Iso (optional)Three letter ISO code for the country that your application focuses on. Other countries will be masked out.Text“iso”: “COD”
hideHeaderHide the application header (including logo, title and menu).Boolean (true or false)“hideHeader”: false,
hideFooterHide the application footer.Boolean (true or false)“hideFooter”: false,
includeDocumentsTabInclude documents tab on the application.Boolean (true or false)“includeDocumentsTab”: true,
mapThemeIds (optional)Link several MapBuilder applications together. Copy the ArcGIS Online application ID for another application and paste it into this field to link the applications together. If you want to add multiple IDs, separate them using a semicolon (;) and add a corresponding map theme title for each application in the map themes field.String“mapThemeIds”: “1c38ba1095fe49e3ba234bf9105c1077;c76d788b7487476bae4d09a4e933be19”,
mapThemes (optional)The map theme field is only necessary if you are connecting several applications together. The map theme indicates the title for your related applications. Make sure the themes are specified in the same order as your map theme IDs. If your application is translated, fill out the “alternativeMapThemes” field with your translated map theme titles.String“mapThemes”: “Forest Atlas of Cameroon;Forest Atlas of Equatorial Guinea”,
“alternativeMapThemes” (optional)The alternative map themes field is used to indicate the title of your related applications in the application’s secondary language. This is only necessary if you translated your application into a secondary language using the alternative language settings and are using the map themes option to connect related applications.String“mapThemes”: “Forest Atlas of Cameroon;Forest Atlas of Equatorial Guinea”,
Print this article

Adjust MapBuilder configuration settings

MapBuilder offers several ways to customize an application. Below is information on how to adjust general settings, alternative language settings, data layer and analysis settings, and other settings on your MapBuilder application. This information will enable you to customize the application template by changing specific properties within the application’s code.

Learn how to do more advanced customizations on GitHub here.

Adjust general settings

The general settings allow you to customize items such as the application text, logos, hyperlinks and the web map. These items are the general attributes of the map that you can directly edit using the code. Learn more about these general attributes on GitHub here.

PropertyExplanationData typeExample
Web mapWeb map ID from ArcGIS Online to use in the application.String“webmap”: “de85e3fcc07948238aa6c1afd2a4eb0”,
LanguageIdentifies the language for the application.String“language”: “en”,
TitleTitle for the application.String“title”: “GFW MapBuilder”,
SubtitleSubtitle for the application.String“subtitle”: “Make maps that matter”,
NarrativeShort description that will be visible in the information tab of the application. Use html tags to edit and customize the formatting of this text.String“narrative”: “This MapBuilder provides an overview of land use in the DRC”,
webmapMenuNameHeading on the menu for a group of data layers that are pulled from the web map.String“webmapMenuName”: “Land Use”,
logoURLURL for an image of your logo.String“logoUrl”: “http://my.gfw-mapbuilder.org/img/gfw-logo.png”,
logolinkURLURL for the website your application will link to when your logo is clicked.String“logoLinkUrl”: “http://globalforestwatch.org/mapbuilder/”,
aboutLinkUrl (optional)Adds an “about” menu item in the header. The link will point to the given URL.String“aboutLinkUrl”: “http://wri.org”,
downloadLinkUrl (optional)Adds a “download” menu item in the header. Link will point to the given URL. This is useful for linking to an open data portal.String“aboutLinkUrl”: “http://wri.org”,
“downloadLinkUrl”: “http://wri.org”,
customColorThemeCustomize the color theme for your application.String“customColorTheme”: “#F0AB00”,

Adjust alternative language settings

Alternative language settings allow you to specify a secondary or alternative language for your MapBuilder application. You can also provide a translated map, title, subtitle, narrative and web map menu name. These settings are only needed if you want to translate your MapBuilder application.

Below are the languages that MapBuilder currently supports.

  • English (en)
  • French (fr)
  • Spanish (es)
  • Portuguese (pt)
  • Indonesian (id)
  • Chinese (zh)
  • Georgian (ka)
PropertyExplanationData typeExample
useAlternativeLanguage (optional)If true, then application will be translated into another language.Boolean (true or false)“useAlternativeLanguage”: false,
alternativeWebmap (optional)Web map ID from ArcGIS Online to use in alternative language.Text“webmap”: “de85e3fcc0798238aa6c1afd2a4ceb0”,
alternativeLanguage (optional)Identifies alternative language for the application.Text“language”: “en”,
alternativeLanguageTitle (optional)Title for the application in alternative language.Text“title”: “GFW MapBuilder”,
alternativeLanguageSubtitle (optional)Subtitle for application in alternative language.String“subtitle”: “Make maps that matter”,
alternativeNarrative (optional)Short description that will be visible in the information tab of the application in alternative language. Use html tags to edit and customize the formatting of this text.String“narrative”: “This MapBuilder provides an overview of land use in the DRC”,
alternativeWebmapMenuName (optional)Heading on the menu for a group of data layers that are pulled from the web map in alternative language.String“webmapMenuName”: “Land Use”,

Adjust data layer and analysis settings

Data layer and analysis settings allow you to add and remove data layers from GFW to your MapBuilder application. Some of the data layers from GFW are added to the MapBuilder template by default.

PropertyExplanationData typeExample
viirsFiresIf true, then the VIIRS fires data layer from NASA will be included on the map.Boolean (true or false)“viirsFires”: true,
modisFiresIf true, then the MODIS fires data layer from NASA will be included on the map.Boolean (true or false)“modisFires”: true,
intactForestsIf true, then the Intact Forests Landscapes data layer will be included on the map.Boolean (true or false)“intactForests”: true,
aboveGroundBiomassIf true, then the aboveground biomass data layer will be included on the map.Boolean (true or false)“aboveGroundBiomass”: true,
landcoverIf true, then the global land cover data layer will be included on the map.Boolean (true or false)“landcover”: true,
mangrovesIf true, then the global mangrove forest data layer will be included on the map.Boolean (true or false)“mangroves”: true,
sadAlertsIf true, then the SAD alerts data layer will be included on the map.Boolean (true or false)“sadAlerts”: true,
gladAlertsIf true, then the GLAD alerts data layer will be included on the map.Boolean (true or false)“gladAlerts”: true,
terraIAlertsIf true, then the Terra-i alerts data layer will be included on the map.Boolean (true or false)“terraIAlerts”: true,

Adjust other settings

Other settings allow for more detailed customization of your MapBuilder application, as well as the ability to connect related MapBuilder applications.

PropertyExplanationData typeExample
Iso (optional)Three letter ISO code for the country that your application focuses on. Other countries will be masked out.Text“iso”: “COD”
hideHeaderHide the application header (including logo, title and menu).Boolean (true or false)“hideHeader”: false,
hideFooterHide the application footer.Boolean (true or false)“hideFooter”: false,
includeDocumentsTabInclude documents tab on the application.Boolean (true or false)“includeDocumentsTab”: true,
mapThemeIds (optional)Link several MapBuilder applications together. Copy the ArcGIS Online application ID for another application and paste it into this field to link the applications together. If you want to add multiple IDs, separate them using a semicolon (;) and add a corresponding map theme title for each application in the map themes field.String“mapThemeIds”: “1c38ba1095fe49e3ba234bf9105c1077;c76d788b7487476bae4d09a4e933be19”,
mapThemes (optional)The map theme field is only necessary if you are connecting several applications together. The map theme indicates the title for your related applications. Make sure the themes are specified in the same order as your map theme IDs. If your application is translated, fill out the “alternativeMapThemes” field with your translated map theme titles.String“mapThemes”: “Forest Atlas of Cameroon;Forest Atlas of Equatorial Guinea”,
“alternativeMapThemes” (optional)The alternative map themes field is used to indicate the title of your related applications in the application’s secondary language. This is only necessary if you translated your application into a secondary language using the alternative language settings and are using the map themes option to connect related applications.String“mapThemes”: “Forest Atlas of Cameroon;Forest Atlas of Equatorial Guinea”,

Related Step-By-Step Instructions