> ## Documentation Index > Fetch the complete documentation index at: https://docs.allgoodhq.com/llms.txt > Use this file to discover all available pages before exploring further. # Visual assets > Generate or upload an image and host it at a stable address on your own subdomain. A **visual asset** is one image, held as a real asset. It has versions, you publish it, and allGood serves it from your branded subdomain at an address that doesn't change. Without this, an image lives wherever the tool that made it put it. Teams end up with logos on four different hosts and no idea which pages use which. You can **generate** an image with Mary or **upload** one you already have. Either way you end up with the same thing: a published image at a stable address. ## Generate an image If you have a picture to start from, such as an earlier banner or a product shot, have it ready. Mary adapts a reference image, which usually works better than building from words alone. A [brand guideline](https://docs.allgoodhq.com/mk/content/brand-guidelines.md) helps too, so the image matches your look. **1. Start the image** In **Content**, select **Create**, then choose **Visual Asset**. You land in **Workshop**, the chat with Mary about this image. There's no setup screen first. Mary opens with two starting prompts, **Generate a visual asset from a brief** and **Make a hosted image from my brand**. Select one, or type your own request. ![Mary's welcome in Workshop, asking what she can help with, with two starting prompts: Generate a visual asset from a brief, and Make a hosted image from my brand](https://mintcdn.com/allgoodtechnologyinc/2ryIb32Og_H3zeEk/images/mk/content/visual-assets/workshop-start.png?fit=max\&auto=format\&n=2ryIb32Og_H3zeEk\&q=85\&s=86e73d0cc09aa0c190091ceb7cb5b3e9) Workshop opens with two starting prompts Tell Mary what the image shows, where it will be used, such as a hero or a banner, and the mood you want. Mention your brand guideline if you have one. Attach a reference image if you have one. **2. Pick one** If your brief is open, Mary offers a few options. Choose the one you want. Ask her to change it, and she adjusts that image instead of starting over. An asset holds one image. For a second image, make a second asset. ![A visual asset in Workshop. The chat with Mary is on the left. On the right, the image's title and alt text sit above the generated image, with a Draft badge and a Publish button at the top](https://mintcdn.com/allgoodtechnologyinc/2ryIb32Og_H3zeEk/images/mk/content/visual-assets/workshop-draft.png?fit=max\&auto=format\&n=2ryIb32Og_H3zeEk\&q=85\&s=fc0ef425132a443aa952f6652a5105ae) A typed request in the chat. The image appears beside it as a Draft, with a description under the title **3. Check the description** Under the image's title on **Summary**, you see a short description of the image. There's no field to edit it. To change it, ask Mary. **4. Preview and publish** Select **Open Preview** to see the image at a private link that expires. Nobody can reach the image until you publish. Select **Publish**, then confirm in the window. ![The deploy card of a published visual asset, showing the file name and type, the address with copy and open buttons, and Publish and Open Preview buttons](https://mintcdn.com/allgoodtechnologyinc/2ryIb32Og_H3zeEk/images/mk/content/visual-assets/deploy-card.png?fit=max\&auto=format\&n=2ryIb32Og_H3zeEk\&q=85\&s=dc2899ae49de05f499041be1a8afdd1a) The card shows the image's file, its address, and the Publish and Open Preview buttons See [Publishing a landing page](https://docs.allgoodhq.com/mk/content/landing-pages/publishing-a-landing-page.md) for what that window shows. It works the same way for an image. When this works, the image loads at its address. The address starts with `/_ag/img/` on your subdomain. ## What you see on the asset page **Summary** shows the image with its title and description. **Details** below it lists the image's width, height and type. The card on the right shows the image's file name and type, its address with buttons to copy and open it, and **Publish** and **Open Preview** buttons. Under the card, the version history lists each step, such as **v1**, **Published** and **Deployed**. ![The Summary of a visual asset showing the image, its title and alt text, and a Details section, with the deploy card and version history on the right](https://mintcdn.com/allgoodtechnologyinc/2ryIb32Og_H3zeEk/images/mk/content/visual-assets/summary.png?fit=max\&auto=format\&n=2ryIb32Og_H3zeEk\&q=85\&s=23b3f1ece8e35d000170ac3a52102fbb) A visual asset's Summary, with its card and version history on the right ## Upload an image If you already have the image, you don't have to generate it. In **Workshop**, attach your image to the chat with Mary and ask her to save it as a visual asset. A logo or an icon in SVG works too. Then publish it as you would a generated image. Width and height can read **0** in **Details** for an image you uploaded. ## Take it down Open the **⋯** menu on the image's card and choose **Take Down…**. Type **OK to take down** to confirm. The address stops showing the image, and any page or email that uses it shows a broken image. Every version is kept, so you can publish it again at the same address. ## Change the image later Ask Mary for a change. She saves it as a new version of the same asset. The address stays the same, so what points at it keeps working. Once you publish the new version, the image is live at that address on the edge right away. Pages and emails that use the address show the new image. You don't republish them. ## Good to know * **Your logo usually belongs in your [brand guideline](https://docs.allgoodhq.com/mk/content/brand-guidelines.md)**, not in a visual asset. Use visual assets for images that a specific email or page shows. * **A downloadable file is something else.** A whitepaper or PDF someone receives is a [hosted file](https://docs.allgoodhq.com/mk/content/hosted-files.md). * **Pictures on your own site** can still be used. See [Using an image you host elsewhere](https://docs.allgoodhq.com/mk/content/visual-assets/images-hosted-elsewhere.md). If you get stuck, contact [support@allgoodhq.com](mailto:support@allgoodhq.com). ## Related articles * [Using an image in an email or page](https://docs.allgoodhq.com/mk/content/visual-assets/using-an-image-in-an-email-or-page.md) * [Using an image you host elsewhere](https://docs.allgoodhq.com/mk/content/visual-assets/images-hosted-elsewhere.md) * [Brand guidelines](https://docs.allgoodhq.com/mk/content/brand-guidelines.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.