FreeAstroAPI LogoFreeAstroAPI
Back to Guides
Developer Guides

Hide ASC, DSC, MC and IC Aspect Lines in SVG Astrology Charts

Hide ASC, DSC, MC and IC aspect lines in SVG birth charts while keeping planet aspects, angle axes and labels visible.

To hide aspect lines connected to the Ascendant, Descendant, Midheaven and IC, set chart_config.show_angle_aspects to false. Keep show_aspect_lines set to true if you still want planet-to-planet aspects in the center of the chart.

{
  "chart_config": {
    "show_aspect_lines": true,
    "show_angle_aspects": false
  }
}

This changes the rendered SVG only. It does not remove the angles, their axes, their labels or the calculated aspect data returned by astrology calculation endpoints.

Side-by-side SVG astrology charts with all aspect lines on the left and only planet-to-planet aspect lines on the right
Side-by-side SVG astrology charts with all aspect lines on the left and only planet-to-planet aspect lines on the right

What show_angle_aspects controls

An angle aspect is any rendered aspect with ASC, DSC, MC or IC as one of its two endpoints. Turning the option off removes both angle-to-planet and angle-to-angle lines. It also removes the matching aspect degree ticks, so the sign ring does not retain tick marks for lines that are no longer visible.

The following chart elements are not removed:

  • Planet-to-planet aspect lines
  • ASC–DSC and MC–IC axes
  • Angle labels such as ASC, DSC, MC and IC
  • French-style AS, DS, MC and FC labels
  • French arrow markers
  • Houses, signs, planets and connector lines
  • Aspect data calculated outside the SVG renderer

The default is true, which preserves the previous chart appearance for existing integrations.

Before: all planet and angle aspects

With show_angle_aspects: true, the renderer includes every enabled aspect line. In the example below, several lines terminate at the four chart angles.

SVG birth chart with planet-to-planet, angle-to-planet and angle-to-angle aspects visible
SVG birth chart with planet-to-planet, angle-to-planet and angle-to-angle aspects visible

This mode is useful when angular aspects are part of the visual interpretation. It can become dense in charts with wider aspect orbs or many enabled points.

After: planet-to-planet aspects only

With show_angle_aspects: false, the same chart keeps its angle axes and labels but removes every aspect line involving ASC, DSC, MC or IC.

SVG birth chart with planet-to-planet aspects visible and angle aspect lines hidden
SVG birth chart with planet-to-planet aspects visible and angle aspect lines hidden

The result gives the planetary aspect pattern more space without turning the aspect layer off completely. For the sample charts in this guide, the setting reduces the visible aspect-line count from 42 to 23 while leaving the birth data and chart geometry unchanged.

Use the setting in the Chart Designer

You can configure the option without editing JSON by hand:

  1. Open the Western Chart Designer.
  2. Select the Chart inspector tab.
  3. Open Aspect Lines.
  4. Leave Aspect lines enabled.
  5. Turn off Angle aspects (ASC/DSC/MC/IC).
  6. Copy the generated request JSON or download the finished chart.

The setting search also recognizes phrases such as “hide aspects between angles and planets.” This is useful when the inspector is open but the correct section is not immediately visible.

Complete natal SVG API request

The following request generates an SVG chart with planet aspects enabled and angle aspects hidden. Replace YOUR_API_KEY with your FreeAstroAPI key.

curl -X POST "https://api.freeastroapi.com/api/v1/natal/chart/" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "name": "Example chart",
    "year": 1990,
    "month": 5,
    "day": 15,
    "hour": 14,
    "minute": 30,
    "time_known": true,
    "city": "London",
    "lat": 51.5074,
    "lng": -0.1278,
    "tz_str": "Europe/London",
    "house_system": "placidus",
    "zodiac_type": "tropical",
    "format": "svg",
    "size": 900,
    "display_settings": {
      "asc": true,
      "dsc": true,
      "mc": true,
      "ic": true
    },
    "chart_config": {
      "show_aspect_lines": true,
      "show_angle_aspects": false,
      "show_angle_labels": true
    }
  }'

The response body is the SVG document. You can return it directly from your backend, save it as an asset or sanitize and embed it according to your application’s security policy.

See the natal SVG chart endpoint documentation for the full request schema, color controls, chart geometry settings and output options.

JavaScript example

The same configuration works in a browser or Node.js application when the API call is made from a secure server route. Do not expose a production API key in client-side code.

const response = await fetch(
  "https://api.freeastroapi.com/api/v1/natal/chart/",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "x-api-key": process.env.FREEASTROAPI_KEY,
    },
    body: JSON.stringify({
      name: "Example chart",
      year: 1990,
      month: 5,
      day: 15,
      hour: 14,
      minute: 30,
      time_known: true,
      city: "London",
      lat: 51.5074,
      lng: -0.1278,
      tz_str: "Europe/London",
      house_system: "placidus",
      zodiac_type: "tropical",
      format: "svg",
      chart_config: {
        show_aspect_lines: true,
        show_angle_aspects: false,
        show_angle_labels: true,
      },
    }),
  },
);

if (!response.ok) {
  throw new Error(`Chart request failed: ${response.status}`);
}

const svg = await response.text();

Related visibility settings

These options control different parts of the chart and can be combined.

SettingResult
show_aspect_lines: falseHides all ordinary aspect lines and their degree ticks.
show_angle_aspects: falseHides only aspects involving ASC, DSC, MC or IC.
show_angle_labels: falseHides angle text or glyph labels but does not filter aspect lines by itself.
show_aspect_symbols: falseHides midpoint aspect glyphs while leaving enabled lines visible.
show_planet_connectors: falseHides planet-to-ring connector lines, not aspects.

If both show_aspect_lines and show_angle_aspects are false, the broader show_aspect_lines setting wins and no ordinary aspect lines are rendered.

When should you hide angle aspect lines?

This option is most useful when you need a cleaner chart at smaller sizes. It works well for mobile reports, chart thumbnails, social cards and interfaces where the planetary aspect pattern is the main visual subject.

Keep angle aspects enabled when the product explicitly interprets angularity or when users expect to inspect aspects to the Ascendant and Midheaven directly from the wheel. The best default depends on whether the chart is intended for detailed study or compact presentation.

For a broader explanation of conjunctions, oppositions, trines, squares and sextiles, read Understanding Astrological Aspects for Developers.

Frequently asked questions

Does this hide the Ascendant or Midheaven?

No. The ASC, DSC, MC and IC axes and enabled labels remain visible. Only aspect lines and aspect degree ticks involving those angles are filtered.

Does it change the calculated natal aspects?

No. show_angle_aspects is a renderer setting. It changes the SVG presentation without mutating the calculated chart data.

Can I hide only ASC aspects and keep MC aspects?

The current option treats ASC, DSC, MC and IC as one group. It does not provide separate per-angle switches.

Does it work with transit, synastry and composite SVG charts?

Yes. The chart configuration uses the shared aspect-line renderer, so the same option applies when those SVG endpoints render aspects involving chart angles.

What happens when the birth time is unknown?

An untimed chart does not have reliable houses or angles. In that case there are no valid ASC, DSC, MC or IC aspect lines to filter. Read the birth chart without birth time guide for the fields that remain reliable.

Read next

All guides