How Aglyn AI builds
When Aglyn AI builds for your site (a page, a component, a layout, a page template, a form or an email), it builds the way a careful designer on your team would: from what the site already has, with your theme and brand, as a draft you review. The rules below are not a suggestion in a prompt. Every plan and every generated document is checked against them before you see it.
Aglyn AI is a release-flagged feature, currently being rolled out — it is not available in every workspace yet. The rules on this page apply to every build as it reaches you.
Where to describe a build
Open the site you are building for, go to the page that lists what you want built, and choose Describe it beside its create button:
- a page on Screens, or Describe a page in AI jobs in the Assist panel; see Generate a page;
- a page template on Templates; see Generate a page template;
- a layout on Layouts; see Generate a layout;
- a form on Forms; see Generate a form;
- a reusable component on Components; see Generate a reusable component.
Describe it is there when your workspace has AI build jobs, you have the Generate with AI permission, and AI is on for the site.
The plan comes first
Before it generates anything, a build job proposes a plan:
- what it will reuse from your site: components, layouts, templates, forms, datasets and collections;
- what it will create, and why nothing you already have will do;
- the screens it will build, each with its layout, address, search title and sections.
A plan only proposes what your workspace can create: what your plan includes, and what your site still has room for. A plan the job could not build is stopped before you are asked to confirm it, with the reason. What a page's plan creates, such as its layout, a card that repeats or its form, is built first when you confirm, in the same job.
The job then waits for you. Open AI jobs in the Assist panel, read the plan, and choose Confirm plan to build it, or Cancel to stop. Nothing is generated until you confirm.
The building rules
- Repeats become one reusable component. A block that appears three or more times on a page, such as the same card with different words, is built once as a reusable component and placed as instances. The AI looks for a component you already have first, and never makes a second copy of one. On a plan without reusable components, such as Free, the block is built into the page each time it repeats instead. Either way, a list of such blocks is one section of the page, never a section for each block.
- Site-wide regions live in the layout. Headers, navigation, footers, announcement bars and cookie notices belong to the site's layout. A generated page sits in your layout and never carries its own copy of them.
- Forms are built on the Forms page, then placed. A form is created with its fields, validation, consent and routing on the Forms page, and a page places it by reference, so you edit it in one place. On a plan without saved forms, such as Free, the page carries the form itself, with its fields, and its submissions reach your inbox like any form's. A search is never built as a form, because a form collects submissions: the AI places a Search Box for your site search, or a Collection Search for the entries of one collection.
- Similar pages share one template. Pages that share a structure and differ by content, such as products, locations, team members or services, are built from one template or bound to a collection.
- Colors, spacing and type come from your theme. Generated content uses your theme's colors, spacing scale and text styles, never a fixed color value. A color your theme lacks is proposed as a theme change for you to review. A link or button on a colored band, such as a footer in your primary color, uses the band's text color, so it stays readable.
- Emails use your brand. Email designs use your brand's colors and fonts, and campaigns start from an email template.
- Reuse before creating. Creating something new is the exception, and the plan says why. A plan never creates something your plan does not include or your site has no room for, and everything it puts on a page is something your site already has or something the plan itself creates.
- Data is bound, not typed. A list you already keep as a dataset, collection or product catalog is bound to it rather than typed into the page, so it stays current. A long list your site does not have yet becomes a proposed dataset.
- Images come from your media library, with alt text. Images are placed from the media library, or left as an empty slot for you to fill, and never linked from another website. Every image has alt text or is marked decorative.
- Navigation and SEO travel with a page. Every new screen gets its own address, a search title and description, and a navigation entry when the brief calls for one. A link goes only to a page that does what its words say: when your site has no such page yet, the link is left out rather than sent to your home page. Every button and link goes somewhere: to a page of your site, to an address the brief gives, or to a section of the same page, which it scrolls to with a Scroll to element interaction you can change. One with nowhere to go is left out.
- One main landmark and an ordered outline. Every page has one main content area, one top-level heading, and headings that step down in order, so it reads well to screen readers and search engines.
- Responsive by your theme's breakpoints. Widths follow your theme's breakpoints instead of fixed sizes, so pages hold up on phones, tablets and desktops. A row of cards or columns is a grid that shows one column on a phone and steps up to several side by side on larger screens.
- Drafts only. Everything the AI builds is a new draft. It never publishes, and never changes a live page in place.
- Your voice, with no filler. Copy follows your site's tone and the brief, with no lorem ipsum, and every heading, subhead and paragraph is finished rather than cut off mid-sentence. Where the brief leaves out a fact, such as a phone number or a price, the AI marks the gap in square brackets instead of inventing it, and AI jobs lists those gaps beside the draft so you can fill them before you publish.
- Start from a duplicate of the nearest thing. When your site has a similar screen, template or email, the job starts from a copy of it, which keeps its bindings and SEO.
- The smallest document that does the job. Generated pages use the fewest elements that render the design: no empty or doubled-up containers, no list item or card with nothing in it, text as text, images that load as they are reached, video that plays on click, and no fonts or third-party embeds you did not ask for.
- A measured size for every output. Each page, component, layout, form and email is measured (elements, stored size, image weight, embeds and fonts) against a budget for its kind, and an email is kept under the size mail apps clip. A job shows a page's estimated first-visit weight before you apply it.
When an answer breaks a rule
A plan or document that breaks a rule is not used. The AI is asked once more and told which rules it broke. If the second answer still breaks one, the job stops and shows you which rules. Choose Try again to ask once more, or cancel the job. Every answer counts toward your AI usage, including the ones that were not used.
Who can use it
Build jobs need the Generate with AI permission. See who can use AI assist.