> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://support.teeinblue.com/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # How to set up Star Maps You can now use the Star Map feature. ![Star Map](https://storage.crisp.chat/users/helpdesk/website/6085dc2a7293d800/image_1xhdqmz.png) The following article will guide you through the set up process of the Star Map feature. # Connect Mapbox & Google Map account | Before we begin, it is required to connect your Mapbox or Google Map account too teeinblue first. This is needed so that you can use the location search function while using the Star Map feature. Visit this [article](https://support.teeinblue.com/en/article/connect-mapbox-google-maps-account-hft6y1/?bust=1627917920340) for detailed instructions. # Setting up the Star Map You can find the Star Map set up dashboard under **Extras > Star maps generator** ![](https://storage.crisp.chat/users/helpdesk/website/6085dc2a7293d800/image_1y0bkve.png) ### Preview Section || To use this search function, first you need to **create a Mapbox account** (and Google Places API - optional), and link it to teeinblue. Visit this [article](https://support.teeinblue.com/en/article/connect-mapbox-google-maps-account-hft6y1/?bust=1627917920340) for detailed instructions. ![Setting up a Preview Location](https://storage.crisp.chat/users/helpdesk/website/6085dc2a7293d800/location_12u98ax.gif) | This location and time are only used for previewing in this generator. It's not the default location showing on Artwork. ### Styling Section In this section, you have various choices to customize the Star Map. Continue reading below to find more details about them. ###### Styling ![Selecting a Style](https://storage.crisp.chat/users/helpdesk/website/6085dc2a7293d800/style_8bbru2.gif) | You can quickly select a pre-set Style here. By doing so, it can save you a lot of time with the configuration. Continue reading below to find out more about each configuration ###### Stars ![Stars](https://storage.crisp.chat/users/helpdesk/website/6085dc2a7293d800/stars_n6pgyt.gif) In this panel, you can control: * **Toggle**: Show/Hide the Star Map * **Size**: The size of the Star Map * **Fill Color**: The color of the Star Map * **Opacity**: The transparency of the Star Map ###### Constellations ![Constellations](https://storage.crisp.chat/users/helpdesk/website/6085dc2a7293d800/cons_1864p43.gif) In this panel, you can control: * **Toggle Show**: Show/Hide the Constellations * **Color**: The color of the Constellations * **Stroke width**: The width of the Constellations * **Stroke opacity**: The transparency of the Constellation * **Name Toggle**: Show/hide Constellations' names * **Name Type**: The Constellations' name types * **Name Color**: The Constellations' name color || You cannot change the font-family of the Constellations' names || This is a pre-determined setting. The Customers cannot customize it ###### Graticule ![Graticule](https://storage.crisp.chat/users/helpdesk/website/6085dc2a7293d800/gra_12dllwo.gif) In this panel, you can control: * **Toggle Show**: Show/hide the Graticule * **Color:** The color of the Graticule * **Width**: The size of the Graticule's line * **Opacity**: The transparency of the Graticule's line || This is a pre-determined setting. The Customers cannot customize it ###### Milky Way ![Milky Way](https://storage.crisp.chat/users/helpdesk/website/6085dc2a7293d800/milk_5d7om6.gif) In this panel, you can control: * **Toggle Show**: Show/hide the Milky Way * **Fill Color:** The color of the Milky Way * **Fill opacity**: The transparency of the Milky Way || This is a pre-determined setting. The Customers cannot customize it ###### Background ![Background](https://storage.crisp.chat/users/helpdesk/website/6085dc2a7293d800/background_19nugp6.gif) In this panel, you can control: * **Fill Color**: The color of the Earth * **Opacity**: The transparency of the Earth's color * **Stroke Color**: The color of the Earth's outline * **Width**: The thickness of the Earth's outline || This is a pre-determined setting. The Customers cannot customize it --- Once you are done with the configuration, you can see a snippet of the Star Map here: ![Your Star Map configuration](https://storage.crisp.chat/users/helpdesk/website/6085dc2a7293d800/image_igy9ho.png) | It is suggestible to make change to your Star Map from the configuration panel above, not directly here. || Please note that you can only save one configuration at a time. Be sure to copy - paste the configuration into your Artwork first, before creating a new one. # Adding the Star Map configuration to your Artwork In your Artwork Editor, create a new layer like you normally do, and select the following setting: ![](https://storage.crisp.chat/users/helpdesk/website/6085dc2a7293d800/image_10d5a1.png) | You can actually use a special shape of your choice here, but recommend using a layer with ratio 1:1 (square). ![Heart-shaped Star Map](https://storage.crisp.chat/users/helpdesk/website/6085dc2a7293d800/image_xdvi8d.png) ||| However, please note that the Star Map is always a Circle Shape put inside a Square Box. See the below image: ![How the Map is displayed inside Artwork Editor](https://storage.crisp.chat/users/helpdesk/website/6085dc2a7293d800/image_zvoh7o.png) ||| Keep this in mind while you design the special shape for the Star Map. All parts outside the dotted circle will be cut off. ![How the special shape works](https://storage.crisp.chat/users/helpdesk/website/6085dc2a7293d800/image_1weh3r2.png) || Please keep in mind that the original layer for the Star Map should always be in a square shape as well. --- In here, you will find a setting panel for the Star Map feature as well. The first thing you should do should be copying your recently created configuration here: ![Copying your configuration](https://storage.crisp.chat/users/helpdesk/website/6085dc2a7293d800/image_11gc4sa.png) || If you want to update the Star Map configuration, please go back to your **Extras > Star maps generator** to create a new configuration In the setting panel inside Artwork Editor, you can: * Set a custom default location (This will override the default location you have set inside **Star maps generator** page) * Set a custom label for each setting * Set a custom placeholder text for each setting * Set a custom show/hide switch for each setting ###### How to set up a default location The location that maps will show when customers haven't selected a location yet. You can change it by entering a latitude & longitude of a location. To get the latitude & longitude of a location: Search a location on [Google maps](maps.google.com) > Right click on the marker > copy the "latitude, longitude" number OR copy it on the url. ![](https://storage.crisp.chat/users/helpdesk/website/6085dc2a7293d800/image_upzcjw.png) --- Once you are done with the setting inside Artwork Editor, the Campaign should look like this: ![Finalizing Settings](https://storage.crisp.chat/users/helpdesk/website/6085dc2a7293d800/image_1695gxv.png) If you are happy with the Campaign, you can go ahead and launch it now! # Auto populate custom data to a custom text field based on the Map selection | You can now add a custom text field to automatically populate new information such as location name, date, time, longitude, latitude, and more. ![](https://storage.crisp.chat/users/helpdesk/website/6085dc2a7293d800/image_1grnsw6.png) In this example, if the Map Location is set to **Berlin, Germany**, both the text field and the Live Preview will automatically set to **Berlin, Germany** as well. To do so, please follow these steps: * Create a text layer like you usually do * Select **Populate values from other options** ![](https://storage.crisp.chat/users/helpdesk/website/6085dc2a7293d800/image_1r35rpz.png) * Continue to select the Layer you want to get value from. In this case, it would be the **Street Map** layer ![](https://storage.crisp.chat/users/helpdesk/website/6085dc2a7293d800/image_uk06q4.png) * Select the type of value you want to get. You can click on the **Lookup values ** button for more details. At the moment, we support these values. We will be continuing to update more in the future! ![](https://storage.crisp.chat/users/helpdesk/website/6085dc2a7293d800/image_17nu5ri.png) * Since you want to get the place name value, then you can copy and paste the `{{place_name}}` value there. | Tips: You can also enter a custom text there along with the custom value ![](https://storage.crisp.chat/users/helpdesk/website/6085dc2a7293d800/image_1a8zbsp.png) * Check your results on the Storefront: ![](https://storage.crisp.chat/users/helpdesk/website/6085dc2a7293d800/image_b6sqwl.png) | Please keep in mind that you can also combine different custom values if you want as well! **NOTES:** * Customers can still edit the text field anytime, even after it's been filled. * If the Customers change the map location again, the text field will update with the new values, which could replace any custom info they added before. | If you need any help, please contact us at support@teeinblue.com