# Troubleshooting

Solutions to common issues on Stargaze.

## Wallet Issues

### Wallet won't connect

**Try these steps:**

1. Refresh the page
2. Make sure wallet extension is installed and unlocked
3. Check for pending popups (may be behind other windows)
4. Try disconnecting and reconnecting
5. Clear browser cache and try again

**Still not working?**

* Update your wallet extension
* Try a different browser
* Disable other wallet extensions temporarily

### Wrong network

If prompted to switch networks:

1. Click "Switch Network" in the popup
2. Or manually switch to Cosmos Hub in your wallet settings

### Transaction stuck/pending

Transactions are usually instant. If stuck:

1. Wait a few minutes
2. Check transaction status in your wallet
3. Refresh the page
4. The transaction may have failed silently - check your balances

***

## Transaction Errors

### "Insufficient funds"

You need ATOM for gas fees. Solutions:

* Get at least 0.1 ATOM in your wallet
* Gas fees are small but required for every transaction

### "Transaction failed"

Common causes:

* Network congestion - wait and retry
* Insufficient gas - shouldn't happen with default settings
* Item already sold - someone else bought it first

### "Rejected by user"

You clicked "Reject" in your wallet. Simply retry and click "Approve" this time.

### "Out of gas"

Rare on Cosmos. If it happens:

* Try the transaction again
* Contact support if it persists

***

## Display Issues

### NFTs not showing

1. Refresh the page
2. Verify you're connected with the right wallet
3. Clear browser cache
4. NFTs may take a moment to index after purchase

### Images not loading

* Images are stored on IPFS
* Slow loading can happen during high traffic
* Try refreshing
* Check your internet connection

### Wrong prices showing

* Prices update in real-time
* Hard refresh (Ctrl/Cmd + Shift + R)
* May be a caching issue - clear cache

### Site looks broken

* Clear browser cache
* Disable browser extensions temporarily
* Try incognito/private mode
* Update your browser

***

## Trading Issues

### Can't buy an NFT

* Item may have just sold
* You may not have enough funds
* Ensure you have ATOM for gas

### Can't list for sale

* Verify you own the NFT
* Check if it's already listed
* Ensure you have ATOM for gas

### Offer not appearing

* Offers need time to index
* Refresh the page
* Check your "Offers Made" in profile

***

## Minting Issues

### Can't mint

* Check if mint is live (timing)
* Verify you're whitelisted (if required)
* Ensure you have enough funds (mint price + gas)
* Check per-wallet limits

### Minted but don't see NFT

* May take a moment to appear
* Refresh your profile
* Check transaction was successful

### Wrong NFT received

* Minting is random within a collection

***

## Account Issues

### Can't update profile

* Ensure wallet is connected
* Try signing out and back in
* Clear cache and retry

### Notifications not working

* Check notification settings
* Verify email/Telegram is connected
* Check spam folder for emails

***

## Getting More Help

### Collect information

Before contacting support, gather:

* Your wallet address
* Transaction hash (if applicable)
* Screenshots of the issue
* Steps to reproduce the problem

### Contact options

* **Discord:** #support channel (fastest)
* **Twitter:** @StargazeZone
* **Email:** For sensitive issues

### Response times

* Discord: Usually within hours
* Complex issues may take longer
* Provide clear details for faster help


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.stargaze.zone/help/troubleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.