01What Figma import does
Figma import turns your Figma design into Husly pages. Every page comes in as a draft, so visitors see nothing until you publish the page yourself. Afterwards you edit the page in the builder like any other page.
People who may manage pages on the site can import. Figma Design files work. FigJam, Slides and Make files do not yet.
Husly can only read your Figma files. An import, a re-sync, deleting an import or disconnecting changes nothing in Figma.
02Connect Figma
Open Tools -> Import/Export and pick Figma.
Click Connect Figma.
Sign in to Figma in the small window and let Husly read your files.
The connection belongs to this site. To remove it, click Disconnect on the same page. Your files in Figma do not change.
Figma gives people with a View or Collab seat only a few file reads a month. Finding the frames uses one read, and an import at most two. Running the same import again uses no new read. When the limit is used up, Husly says so plainly and shows Figma's plans.
03Name your frames before the import
Husly makes one page from each top-level frame in Figma. Put each page in its own frame. Husly knows the desktop and the phone version of one page by the frame name. These names are one page called "Home":
Home
Home - Mobile
Home / 375
Mobile / Home
Write the device word in English (Mobile, Phone, Tablet or Desktop), or write the frame's width as a number. When the name has no device, the frame's width decides: up to 480 pixels is a phone, under 1024 pixels a tablet, and a wider frame a desktop.
When you copy the link of one frame in Figma, Husly picks that frame first. With the file's link you see every frame.
04Import the design
Copy the file's link in Figma: Share -> Copy link.
Paste the link into Figma file link and click Find frames.
Click Pick frames. Each row is one page, and its desktop and mobile frames come in together. You can pick up to 30 frames in one import.
Decide on the switch Use these colors and fonts. It starts off, and your site keeps its own theme. A new site with no pages yet takes the design's colors and fonts anyway.
Click the Import button, which shows the number of frames you picked, for example Import 4 frames. An import can take a minute. You can leave the page, and the import goes on.
One import runs on a site at a time. You can start a new one when the last one ends.
Every site gets a few free imports each month. Before you start, the page shows how many are left this month. After that an import uses AI credits, and the page tells you the cost first. An import that fails does not use a free import and takes no credits.
05What an import makes
Husly first makes a restore point and then saves every page as a draft. When the import ends, you see a report:
how many draft pages it made, with an Open page button beside each page;
which fonts it swapped: a font Husly cannot serve is swapped for the closest free font;
the module records it made, which are drafts that you check before you publish them;
how many pages it could not make when the plan's page limit was reached.
Photos and logos are saved in the site's media library, in the folder "/figma", so a page does not depend on Figma's addresses.
Each section of the design comes in on the builder's 24-column grid. Headings, texts, buttons, pictures, big icons and cards sit where the design has them, and you can drag every part afterwards. The page background, the rounded box around the content and the design's content width come in too. On a phone each part is full width and in reading order.
Buttons take the main color of the site's theme, not each button's own color. The design's grey picture places are left out. The import adds menu items only when the site has no published page yet. Otherwise the items are listed in the report, so the header does not link to a draft.
06Module pages
The import also reads what a page is about and builds a module page with the module's own widget. When Husly is not sure, it uses its best guess and the report asks you one question.
[object Object]Nothing is published, no module is turned on, and payments stay off. When your plan does not have the module, or it is turned off, you see the widget as a preview.
Prices from the design come in as sample prices. Check the price and the other details on the module's own page before you publish a course, a service or a work.
07Take in the design's changes
When the design changes in Figma, you can take the changes in. Your own edits in Husly stay.
Find the work in the list Imported works and click Re-sync. Husly reads the file once more.
Look through what changed in Figma, page by page: Changed in Figma, New in Figma or Removed in Figma. A section nobody touched in Husly is ticked already.
A section with the label Edited in Husly stays unticked. If you tick it, the Figma version replaces your edit. A page that visitors can see already shows Page is live.
Click, for example, Take 3 changes. Husly makes a restore point first.
A re-sync that uses only rules does not count as an import. When it asked the AI about new parts, it counts like an import. Imports made before re-sync came out cannot be re-synced: import them again.
This switch is beside each work and starts off. When you turn it on, Figma asks for one more permission in a window. When someone edits the file, the work gets the label Design changed in Figma, and the people who manage pages get an email and a push notice. Nothing changes on the site by itself. Figma allows at most three such alerts on one file, and not every Figma plan may allow them. You can turn the notice off in your account's notification settings, on the row "Figma design changes".
08Import from your AI app
When you have connected Claude or another AI app to your site, you can also bring a Figma design in through the chat. Paste a Figma frame link into the chat and write, for example, "import this Figma frame into my site". The app starts the same import: the pages come in as drafts, and a restore point comes first.
The app can also tell you how the import went and which draft pages it made, and re-sync the design. When a section was edited by hand in Husly, the app must ask you first.
The app uses the site's own Figma connection and the same free imports and credits. AI app connections are in the paid plans. The change alert switch stays on the admin's Figma page.
09Start a new site from Figma
Open the start page and choose Bring my old site over, then A Figma design.
Click Connect Figma, paste the file's link and click Scan design. You see the design's colors, fonts and pages at once.
Pick the pages and click Build my site from this design. Then make your account.
The new site gets the Figma connection, and the import starts at once. It is a normal import, so it counts as one of this month's free imports. When you start from Figma, you make the account with your email for now, because the Google sign-in is hidden on this path.
10Undo or delete an import
Every import and re-sync starts with a restore point. Open Settings -> Restore points and restore the point from before the import. In the list its name is Before applying a template for now.
You can take a test import off the list:
In the list Imported works, click Delete beside the work.
Leave on the box that also deletes the pages of this import that are still drafts.
Click Delete import.
Published pages, the pictures in the media library and module records stay. Nothing changes in Figma.