> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://customix.crisp.help/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).

# Star Map Personalization

The **Star map** option renders an actual chart of the night sky, positioned the way it looked from Earth on a specific date, directly onto the product. It's the option to reach for when a customer wants a keepsake tied to a meaningful date, a birthday, wedding, or anniversary, with the constellations as they truly appeared that night.

To add it, go to **Option sets** in the sidebar, open the option set for your product, click **Add option**, choose **Star map** under Others, then click **Add**.

![Option sets in the sidebar navigation](https://lh3.googleusercontent.com/d/1eSG6tbQIq00QFn_B4eMosSjPerZod6XL=w1000)

![Add option button in the option set editor](https://lh3.googleusercontent.com/d/15qrVKeJ9M_ttGSdH9Gfj4VIB_s64QBLs=w1000)

![Add option menu with Star map selected under Others](https://lh3.googleusercontent.com/d/1DexnqlPWssDvrHwUE0KRCNEWAAMM8GUx=w1000)

# Content

* **Personalize with date picker**: ticked on by default, this is what makes Star map a real customer-facing option, exposing a **Label**, **Help text**, **Default date**, and **Required** field, plus a date picker in the storefront preview so the customer can choose the date their map is generated for
* **Label**: the field name shown above the date picker, defaults to "Star Map"
* **Help text**: optional guidance shown below the label
* **Default date**: the date used to render the map before a customer picks one of their own
* **Required**: forces the customer to pick a date before they can complete the order

![Content panel with Personalize with date picker checked, showing Label, Help text, Default date, and Required fields](https://lh3.googleusercontent.com/d/1tTZ4LCnFS3Xqt32PJzRYelHh7Bo9SUJ2=w1000)

Unticking **Personalize with date picker** removes all of those fields, along with the **Condition** section, and the map disappears from the **Option set preview** entirely. In this state Star map isn't a customer-facing option at all, it's a fixed decorative layer that always renders whatever date is baked into its settings, useful for a design that should always show a specific sky (a launch date, a founding date) without asking the customer anything.

![Content panel with Personalize with date picker unchecked, only the checkbox remains and the option disappears from Option set preview](https://lh3.googleusercontent.com/d/1129bgLtBJmZb2y4HYTd-VL0K9-iQJ0UE=w1000)

With **Personalize with date picker** back on, clicking the date field in the **Option set preview** opens a plain month/year calendar for the customer to pick from.

![Option set preview with the date picker calendar open](https://lh3.googleusercontent.com/d/15CK3fQwu8UDZPyHB_Ff0E38-_MMjibJM=w1000)

Picking a date re-renders the map on the canvas to match the real sky positions for that date.

![Option set preview and canvas after selecting July 14, 2026, showing the star map redrawn for that date](https://lh3.googleusercontent.com/d/1sN5Te14LaPX9CLSJRIgdiiguJjzRR269=w1000)

# Milky way

Controls the soft band representing the Milky Way across the map.

* **Show milky way**: toggles the band on or off, ticked by default
* **Color**: the band's color, defaults to white
* **Opacity**: how visible the band is, from 0 to 1, defaults to 0.1
* **Sky color**: the background color of the map itself, defaults to a dark navy

![Milky way panel with Show milky way, Color, Opacity, and Sky color fields](https://lh3.googleusercontent.com/d/1rNjZeOV6Mr-X1Bhy4szXiSpgn65CW8UC=w1000)

# Constellations

Controls the constellation line art drawn between stars.

* **Show constellations**: toggles the lines on or off, ticked by default
* **Color**: the line color, defaults to a light grey
* **Width**: the line thickness, defaults to 1
* **Opacity**: how visible the lines are, defaults to 0.4

![Constellations panel with Show constellations, Color, Width, and Opacity fields](https://lh3.googleusercontent.com/d/171yrDgYAPLWlDwWy7tCJIPOB3U30Ip-z=w1000)

# Graticule

Controls the coordinate grid overlaid on the map. Unlike Milky way and Constellations, this is off by default.

* **Show graticule**: toggles the grid on or off, unticked by default
* **Color**: the grid line color, defaults to a light grey
* **Width**: the line thickness, defaults to 1
* **Opacity**: how visible the grid is, defaults to 0.4

![Graticule panel with Show graticule checked and Color, Width, Opacity fields, grid visible on the canvas map](https://lh3.googleusercontent.com/d/1tp2eviVD3M70ljMzKpqD9t-e1jflALN5=w1000)

# Transform

The standard **Width**, **Height**, **X**, **Y**, **Skew X**, **Skew Y**, alignment, and flip controls for positioning the map on the canvas, the same Transform panel shared by other canvas-based option types.

![Transform panel with Width, Height, X, Y, Skew X, and Skew Y fields](https://lh3.googleusercontent.com/d/1hYvGjgaH0Cpi5No_GivjKMASFjW9RGYz=w1000)

# Condition

Like most option types, Star map supports its own conditions, so you can show or hide it based on a selection elsewhere in the option set, for example an Additional Swatch or Checkbox toggle. Note this section only appears while **Personalize with date picker** is ticked. See the Conditional Option Sets guide if you want to set that up.

> 📌 Don't forget to click **Save** once you're happy with the setup, and make sure the option set's status is **Active** (not Draft). Customers won't see the Star map option on your storefront until both are done.