Visual style guidelines
Visual style guidelines tell EkLine’s agents which colors and look to use when they draw an image for your docs or content.
Before you begin
Section titled “Before you begin”- You set visual style guidelines in Company Profile. Any member of your organization can edit it. See Company Profile and Domains.
- The Marketing Agent always uses them. The Docs Agent uses them only when company context is on for your organization. To check or change this, contact support@ekline.io.
Where they are used
Section titled “Where they are used”Both agents draw each image as shapes, text and diagrams, then save it as a PNG file. They never produce photographs.
| Agent | When it draws an image |
|---|---|
| Marketing Agent | For a blog post, a cover and an inline diagram; for a LinkedIn post, one image when it strengthens the post; for a newsletter, section images when a section is clearer with one. At most three images per draft. You can ask for a different image, a change, or none. |
| Docs Agent | When a page needs a picture that is not a Mermaid diagram, such as an illustration, or a diagram on a site that does not render Mermaid. |
The agents take your colors and style notes from the Visual Style Guidelines field and nowhere else. With the field empty, or with no colors in it, images use a neutral palette.
What to write
Section titled “What to write”Write two parts: your colors, then a few sentences about the look.
Colors. Put each color on its own line, with a role and a hex value such as #2563eb (a CSS color name such as navy also works). The agents fill five color roles from these labels:
| Label you write | What it colors |
|---|---|
Primary, Brand or Accent | The accent: one focal element, one emphasized line, badges and arrowheads |
Secondary | The accent when there is no Primary, Brand or Accent color; otherwise a fallback |
Dark | The background of a dark image; boxes and strokes on a light one |
Background | The background of a light image |
Light | Text on a dark image; card fills on a light one |
Text or Ink | Body text on a light image |
If two colors would be hard to read together, the agent swaps one for another color from your list or a neutral one.
Style notes. In plain sentences, describe the look: which shapes and motifs, how busy or empty, line weight, rounded or square corners, flat fills or a soft glow, and whether to use gradients.
An image never follows a note that asks for a named font, a logo or other file, photographs, people or faces, or a color outside the five roles. Images can’t include logos, uploaded images or named fonts. The Marketing Agent tells you in chat which notes an image does not follow, and why.
Example
Section titled “Example”Acme, a developer tool company with a blue brand, might write:
Primary: #2563ebDark: #0f172aBackground: #f8fafcText: #1e293b
Flat, geometric illustrations with generous whitespace.Rounded corners and thin lines. No gradients.-
Go to Settings > Organization > Company Profile.
-
Find the Visual Style Guidelines field, near the end of the form.
-
Write your colors, one per line with a role, then your style notes. The field holds up to 10,000 characters.
-
Click Save Changes. The message Company profile saved successfully confirms the save.
The change applies to images drawn in sessions started after you save.
Check it worked
Section titled “Check it worked”-
Start a new Marketing Agent session and ask for a short blog post with a cover image.
-
Open the image in the draft and check that it uses your colors and style.
-
Read the agent’s summary in chat. It lists any style note the image does not follow.
Troubleshooting
Section titled “Troubleshooting”Images use neutral colors instead of yours
Section titled “Images use neutral colors instead of yours”- Put each color on its own line, with a role label and a hex value, as in the example.
- Start a new session after you save. A session that was already open keeps the guidelines it started with.
- The Docs Agent uses them only when company context is on for your organization. See Before you begin.
The Visual Style Guidelines field isn’t there
Section titled “The Visual Style Guidelines field isn’t there”The field is part of Company Profile. If you don’t see Settings > Organization > Company Profile, contact support@ekline.io with your organization name.
- Company Profile and Domains: Fill in the rest of your company’s profile.
- Custom instructions: Add standing instructions for one agent.
Built on Potluck Docs, our open source template.