> ## Documentation Index
> Fetch the complete documentation index at: https://docs.macrovisonomics.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Settings

> Customize your MACROVISONOMICS experience

# Settings

Configure your MACROVISONOMICS account and preferences to personalize your experience.

## Accessing Settings

Click your profile icon in the top navigation bar and select **Settings**, or navigate directly to the Settings page from the menu.

## Account Settings

### Profile Information

Manage your public profile:

| Setting             | Description                              |
| ------------------- | ---------------------------------------- |
| **Display Name**    | The name shown on your published charts  |
| **Bio**             | Short description about you or your work |
| **Profile Picture** | Your avatar shown in the community       |
| **Email**           | Your account email address               |

### Account Actions

* **Change Password**: Update your login credentials
* **Connected Accounts**: Manage linked social/SSO accounts
* **Delete Account**: Permanently remove your account and data

## Preferences

### Display Preferences

<CardGroup cols={2}>
  <Card title="Theme" icon="palette">
    Choose between Light mode, Dark mode, or System default.
  </Card>

  <Card title="Default Chart Type" icon="chart-line">
    Set your preferred chart type for new visualizations.
  </Card>

  <Card title="Language" icon="language">
    Select your preferred interface language.
  </Card>

  <Card title="Date Format" icon="calendar">
    Choose how dates are displayed.
  </Card>
</CardGroup>

### Chart Defaults

Set default options for new charts:

| Setting                | Options                                      |
| ---------------------- | -------------------------------------------- |
| **Default Time Range** | Last 10 years, 20 years, All available       |
| **Color Scheme**       | Classic, Vibrant, Muted, Colorblind-friendly |
| **Show Legend**        | Always, Auto, Never                          |
| **Show Grid**          | On/Off                                       |
| **Animation**          | Enabled/Disabled                             |

### Data Preferences

* **Default Countries**: Pre-select your most-used countries
* **Favorite Indicators**: Quick access to common metrics
* **Aggregation Method**: Sum, Average, or Weighted Average

## Notifications

### Email Notifications

Control which emails you receive:

| Notification        | Description                         |
| ------------------- | ----------------------------------- |
| **Chart Comments**  | When someone comments on your chart |
| **New Followers**   | When someone follows your profile   |
| **Weekly Digest**   | Summary of community activity       |
| **Product Updates** | New features and improvements       |

### In-App Notifications

Manage notification badges and alerts:

* Comment notifications
* Like notifications
* System announcements

## Privacy Settings

### Profile Visibility

* **Public Profile**: Anyone can see your profile and charts
* **Private Profile**: Only published charts are visible
* **Hidden Profile**: Profile not discoverable (charts still accessible via link)

### Data & Analytics

* **Search History**: Enable/disable search history saving
* **Usage Analytics**: Opt in/out of anonymous usage data

## Security

### Session Management

* View active sessions
* Sign out from all devices
* Set session timeout preferences

### Two-Factor Authentication

Add an extra layer of security:

1. Go to Settings → Security
2. Enable Two-Factor Authentication
3. Scan QR code with authenticator app
4. Enter verification code

## Subscription & Billing

### Current Plan

View your current subscription status:

* Plan name and features
* Billing cycle dates
* Usage statistics

### Manage Subscription

* **Upgrade Plan**: Access more features
* **Change Plan**: Switch between tiers
* **Cancel Subscription**: End your subscription
* **View Invoices**: Access billing history

See the [Plans](/features/plans) page for detailed plan comparison.

## Data Management

### Export Your Data

Download all your data:

* Saved charts (JSON format)
* Search history
* Account settings

### Clear Data

Remove stored data:

* Clear search history
* Clear cached data
* Reset preferences to defaults

<Warning>
  Clearing data cannot be undone. Export your data first if you might need it later.
</Warning>

## Keyboard Shortcuts

View and customize keyboard shortcuts for common actions:

| Shortcut       | Action          |
| -------------- | --------------- |
| `Ctrl/Cmd + K` | Open search     |
| `Ctrl/Cmd + S` | Save chart      |
| `Ctrl/Cmd + D` | Duplicate chart |
| `Esc`          | Close dialogs   |

## API Key Management

Pro, Gold, and Enterprise users can create and manage API keys for programmatic access to MACROVISONOMICS data directly from Settings.

### Accessing API Keys

Navigate to **Settings → Developer** or visit the [Developer Portal](https://macrovisonomics.com/developers) to manage your API keys.

### Creating an API Key

<Steps>
  <Step title="Go to Developer Settings">
    Navigate to Settings and click the **Developer** tab, or go directly to the Developer Portal.
  </Step>

  <Step title="Click Create API Key">
    Click the **"Create API Key"** button. Give your key a descriptive name (e.g., "My Research Script" or "Dashboard App").
  </Step>

  <Step title="Copy Your Key Immediately">
    Your API key is shown **only once**. Copy it to a secure location — it will not be displayed again. If lost, you will need to create a new key.
  </Step>

  <Step title="Use in Your Requests">
    Include the key in the `X-API-Key` header of all API requests:

    ```bash theme={null}
    curl -H "X-API-Key: your_key_here" \
      https://macrovisonomics.com/api/v1/search?q=GDP+growth
    ```
  </Step>
</Steps>

### Managing API Keys

| Action                     | Description                                                              |
| -------------------------- | ------------------------------------------------------------------------ |
| **View usage**             | See request counts and quota usage for each key                          |
| **Rename**                 | Update the label for an existing key                                     |
| **Revoke**                 | Immediately invalidate a key — any requests using it will fail instantly |
| **Create additional keys** | Create separate keys for different projects or environments              |

### API Key Security

<Warning>
  Treat API keys like passwords. Never commit them to version control, include them in client-side code, or share them publicly. Revoke any key you suspect has been compromised.
</Warning>

Best practices:

* Use environment variables to store keys in your code
* Create separate keys for development and production
* Rotate keys periodically by revoking old ones and creating new ones
* Grant minimum necessary access per key (use separate keys per project)

### Rate Limits by Plan

| Plan       | Requests/Minute | Monthly Quota |
| ---------- | --------------- | ------------- |
| Pro        | 60              | 500           |
| Gold       | 200             | 2,000         |
| Enterprise | Custom          | Unlimited     |

Rate limit headers (`X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`) are included in every API response.

See the [Developer API docs](/features/developer-api) for full endpoint documentation and code examples.

## Related Features

* [My Space](/features/my-space) — manage your saved charts and collections
* [Plans & Pricing](/features/plans) — compare plans and manage your subscription
* [Developer API](/features/developer-api) — full API documentation and MCP Server setup