How to build the brief for Figma to WP projects

  • publication date
    May 5, 2026

Many agency owners and directors know the power of brief, but due to high amount of tasks during the day – briefs are usually neglected – quick notes or just a Figma link

I wrote this guide to help digital agencies deliver better service to their clients by using power of clarity

  • Project terms
  • Technologies
  • Environments and process
  • QA approach

Project terms

This part should set expectations for both parties:

Budget

Include fixed price or budget range to get the most accurate quotes. You’ll hardly ever save any money when asking a contractor to just name the price in website development, because in most cases the full possible scope of work for any contract is higher than the budget for it.

Imagine a situation: you have a 5 000$ budget on website development and get quotes within 1 000$ and 15 000$ range. More likely you’ll ignore everything lower than 4 000$ and higher than 6 000$ for the job, because they either won’t meet your standards or the budget

Another important point – from my experience most briefs are bloated with stuff that require a lot of work but have low value for the end client or user. So when you specify the budget – you likely will get more accurate quotes in terms of scope of work.

Sometimes you may get even 2 quotes – with fully described scope of work that is higher than your budget and alternatives that match your budget but suggest to cut off some features or use alternative routes.

Deadline for development

This is time when you won’t make any pressure on contractor and expect them to work on the Website, QA etc. you just need to get polished results by this date

Launch date/month

This should have some buffer from the development deadline to make your agency implement final touches. Usually website is part of a big plan:

  • Rebrand
  • Redesign
  • New strategy etc.

In order to hit the deadline without burnout – every contract needs some buffer.

Phases of the project

You may get everything at one point, or get delivered with some parts of the job. Ex: Homepage – week 1,

Archive pages – week 2,

Single pages – week 3,

Inner pages – week 5,

QA – week 6-7

Launch – week 10

Payment schedule

Getting paid on time is important for you and for your contractor. Align contractor payment terms with your payment terms with the client, but make sure the contractor doesn’t get penalized if the client has not paid your invoice. When work is done – it should be paid

Other things that depend on this project

Ex: SEO part, Content Part, Adding translations etc. – explain who may need to be plugged-in the project on later stages to prioritise development of certain functionalities but ensure no work will be lost

Technologies

Most agencies don’t specify the selection of technologies and then deadlines needs to be moved because some things are built not as they expect from the start

CMS

WordPress, Headless WordPress, etc.

Theme

Any theme, Specific theme, Child theme to specific theme, your agencies custom theme, etc.

Project type

  • New website
  • Redesign from scratch
  • New theme but need to save old database 

Editing experience:

ACF templates, ACF Blocks, ACF Flexible content, Page Builder

If you prefer using certain field types or settings for certain situations – let contractor know

Ex: Using ACF Link is great for buttons, but am getting mad when somebody uses URL or URL + text, haha.

Another ex: Text field vs Wysiwig editor – let contractor know what do you prefer and when to make sure all copy will look great at the end

Global blocks:

List out what kind of content should be edited globally, to make life of content team easier. These blocks will be edited in 1 place and content can be used as many time as you need.

Remember the last time you needed to add new amazing client logo on 150 pages on client’s site. Annoying and time consuming operation isn’t it? With global blocks it could be done in minutes

Common global blocks:

  • FAQs,
  • CTAs,
  • Testimonials,
  • Social Media,
  • Contract forms,
  • Logos carousels etc.

Content hierarchy – CPT

The bigger website – the more post types and taxonomies website might need. This is what makes it clear in terms of editing experience and good for SEO

If you’re not sure – let contractor know and you’ll define this together.

If you’re sure – better to make things correctly from the first try

Sitemap

This will help to see that some pages like search results, default text page, 404 etc, should have some designs as well and will make sure nothing is missing or require additional budget at the end of the project

Additional functionality and APIs

Search functionality,

Filtering,

Recommended articles/ products

While it may be self-explanatory to you, as you spent hours on calls with team and clients, but contractor have no idea how this should work: 

Examples

Search

  • with Ajax or a separate page? 
  • Is it clear how the search results page looks? 
  • Do you need any search requests, analytics etc?

Filtering

  • do you have designs for active, not active filters
  • mobile designs
  • design when nothing is found, 
  • Does the filter allow multiselection? 
  • Is it an AND or OR filter?

Plugins

Probably the most underrated part, agencies usually just add – use as small amount of plugins as possible, but, let’s break this down

I divide plugins into 2 categories:

Functional and visual

Functional are

  • Seo plugins
  • Caching plugins
  • Lazy-load plugins
  • Image conversion plugins,
  • Redirection plugins
  • Multi-lingual plugins
  • Migration and backup plugins
  • Duplicate/reorder and things to make admin more friendly for users

Visuals:

They should not be used usually and core difference from functional is that they add a lot of JS,CSS on the front-end and are replaced by custom code usually

  • Popups
  • Sliders
  • Author boxes
  • Etc

So, take the list above and add a preferred plugin name. Add Yoast SEO or Rank Math, add WpRocket or Nitropack, etc.

Especially, if you have paid licenses.

Marketing integrations

List out what else is planned to be added to the website. 

  • Email capture
  • Google Analytics,
  • Search Console verification
  • Chats
  • Hubspot etc

Environments and process

Styleguide


Do you have a styleguide for CSS, JS, Git commits?

Server

Do you have a staging environment or should a contractor provide this?

Git

Do you have your own git with CI/CD?

Do you have any brunch strcutture for the internal team to review changes?

Accesses to add:

  • Wp Admin on staging
  • FTP to staging
  • Phpmyadmin to staging (Optional)
  • Cloudflare (Optional)

QA approach

Make it clear if website should be based on Figma designs or it will be checked with Perfect Pixel

What are your responsive expectations

How you’re going to test speed

How you’re going to test accessibility

Do you expect to involve somebody from the core team for QA or expect polished delivery from contractor

Who’s primary contact on your for these questions 

  • Server issues
  • Design questions
  • Project related questions (PM) 

I hope you found this helpful guide.

Find more interesting content about wordpress development for digital agencies on my youtube – https://www.youtube.com/@wp-talks

I would be grateful for your subscription

Vitalii Omelchenko
Founder at Codelibry and WordPress enthusiast. Helping digital agencies to protect their margins and do better at website delivery.Need help with wordpress builds? Book a call using the Contact page
our Blog

Explore our Latest Insights

company icon
How to add Google Analytics to WordPress
WordPress
May 4, 2026
company icon
How to improve SEO WordPress in 2026
WordPress
May 1, 2026
company icon
How to improve WordPress security
WordPress
April 21, 2026
whatsapp icon