Skip to content

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.

  • 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.

Both agents draw each image as shapes, text and diagrams, then save it as a PNG file. They never produce photographs.

AgentWhen it draws an image
Marketing AgentFor 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 AgentWhen 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.

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 writeWhat it colors
Primary, Brand or AccentThe accent: one focal element, one emphasized line, badges and arrowheads
SecondaryThe accent when there is no Primary, Brand or Accent color; otherwise a fallback
DarkThe background of a dark image; boxes and strokes on a light one
BackgroundThe background of a light image
LightText on a dark image; card fills on a light one
Text or InkBody 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.

Acme, a developer tool company with a blue brand, might write:

Primary: #2563eb
Dark: #0f172a
Background: #f8fafc
Text: #1e293b
Flat, geometric illustrations with generous whitespace.
Rounded corners and thin lines. No gradients.
  1. Go to Settings > Organization > Company Profile.

  2. Find the Visual Style Guidelines field, near the end of the form.

  3. Write your colors, one per line with a role, then your style notes. The field holds up to 10,000 characters.

  4. Click Save Changes. The message Company profile saved successfully confirms the save.

The change applies to images drawn in sessions started after you save.

  1. Start a new Marketing Agent session and ask for a short blog post with a cover image.

  2. Open the image in the draft and check that it uses your colors and style.

  3. Read the agent’s summary in chat. It lists any style note the image does not follow.

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.

Built on Potluck Docs, our open source template.