How a Marketer Migrated a WordPress Site to a Hugo Multilingual Site with Codex

Sharing the experience of a non-developer marketer rebuilding the 247COMPASS website, along with a structure-centric 7-step building framework to minimize repetitive work.

How a Marketer Migrated a WordPress Website to a Hugo Multilingual Site with Codex

I am a marketer, not a developer. While I could handle content and brand messaging directly, changing the site’s structure and code required a developer’s assistance.

This time, working alongside Codex, I rebuilt the 247COMPASS WordPress website into a Hugo-based Korean and English site. I have organized the process sequentially, starting from content migration to multilingual configuration, search settings, deployment, and operational tools.

Looking back on the experience, this article outlines a working framework that can be reused for future builds.

There was one core principle: Establish the big picture first, then finalize the details.

1. What Did We Build?#

Overview of this website build
ItemApproach Chosen for This Build
Previous SiteWordPress corporate website
New FoundationHugo static site
DesignUtilized the default structure of hugo-theme-pico-corp
LanguagesKorean default, English at /en/
Key ContentHome · About · Services · Projects · Insights · Contact
DeploymentConnected GitHub and Cloudflare Pages
Operational ToolsAuthoring guides, reusable CTAs, translation sync scripts

The goal went beyond simply refreshing the website’s look. It was vital to create a structure that allowed me, as a marketer, to continuously edit and manage content.

2. First Decision: Utilizing a Ready-Made Design#

Rather than building a new design from scratch, I chose a theme suited for a corporate website. I liked its clean layout and business-centric interface.

The strategy was to maintain the default structure of the home, services, about, project list, and detailed reference pages while populating them with our own company’s content.

Design Decisions and Content Focus Areas
What I Decided FirstWhat I Could Focus On Afterward
Maintain the theme's default layoutDraft services and brand messaging
Standardize service detail page formatsOrganize descriptions needed by customers
Standardize project detail page formatsOrganize challenges, approaches, and results
Align Korean and English structuresReview translation terminology and phrasing

I showed reference pages to Codex and requested, “Change the content while keeping this structure.” I specifically added the scope of application, elements to preserve, files to modify, and validation criteria.

3. Why Start with the Big Picture?#

Even if you finalize button colors or individual sentences first, changes to the page structure will force you to readjust them. Therefore, I established menus, content types, and multilingual paths first before refining the details.

Task Distinction Between the Big Picture and Details
Big Picture to Establish FirstDetailed Elements to Complete Later
Site objectives and primary visitorsPage-specific messaging and copy
Menus and content typesCards, buttons, and spacing
URLs and multilingual connection structureLink labels and translation expressions
Service and project detail formatsImages and results for each case study
Roles and placement of common componentsCTA phrasing and icons

While starting with the big picture, it is best to validate using actual content on representative pages. Empty layouts alone make it difficult to spot issues like long titles, result lists, or awkward mobile line breaks.

4. If Rebuilding: The 7-Step Framework#

Below is the recommended sequence reorganized based on this experience. This is not a schedule representing actual task durations, but rather the order in which decisions in earlier steps serve as criteria for subsequent steps.

Objective → Structure → Representative Pages → Common Elements → Content → Deployment → Operations

  1. STEP 01 · Direction Setting

    Organizing Objectives and Existing Assets

    Determine what to communicate to whom and what actions to drive. Organize existing content, URLs, and images to distinguish what to keep versus exclude.

    Completion Criteria · Site objectives, content inventory, existing URL list

  2. STEP 02 · Structural Design

    Determining Menus, URLs, and Multilingual Rules

    Establish content types and menus, and connect Korean and English paths. Also design redirect plans for previous URLs and translation criteria at this stage.

    Completion Criteria · Sitemap draft, URL rules, language-specific content mapping table

  3. STEP 03 · Small-Scope Validation

    Validating Layouts with Representative Pages

    Create one each of the home, service detail, project detail, and insight pages. Populate with actual content and check information flow on desktop and mobile.

    Completion Criteria · Reviewed representative pages and list of items to modify

  4. STEP 04 · Finalizing Common Elements

    Making Repetitive Functions Reusable

    Organize headers, footers, CTAs, author cards, table of contents, and image display methods. Apply across all pages after verifying on representative pages.

    Completion Criteria · Common components, shortcodes, authoring examples

  5. STEP 05 · Content Expansion

    Synchronizing English After Finalizing Korean

    Review Korean messaging and case studies first, then draft English versions based on the glossary. Verify client names, metrics, links, and language switching.

    Completion Criteria · Reviewed Korean/English content and Korean-English glossary

  6. STEP 06 · Preparation for Launch

    Technical Validation and Deployment

    Check redirects, meta information, sitemaps, structured data, analytics tools, and performance. Re-verify links and key pages on the live domain after deployment.

    Completion Criteria · Successful build, live site verification, remaining issues list

  7. STEP 07 · Ongoing Operations

    Establishing Guides and Automation

    Document content creation, preview, and deployment procedures. Validate translation automation starting with a small scope and set protection rules for manually reviewed files.

    Completion Criteria · Operations guide, automation tools, human review criteria

Proceed to the next step only after verifying the completion criteria for each step. If structural issues are discovered belatedly, return to the relevant step to revise the criteria and check affected pages.

5. Sequence Adjustments for Future Builds#

While maintaining the big-picture-first approach, I would like to move the following tasks earlier next time:

Task Sequence Improvements for Future Builds
ItemDesired Approach Next TimeReason
Existing URLs and RedirectsDraft inventory and migration plans before moving contentTo minimize missing connections between old and new addresses
Common CTAs and Author CardsFinalize on representative pages before global applicationTo reduce repeated edits across multiple files
TranslationProceed after finalizing Korean structure and core messagingTo reduce re-translation caused by Korean edits
Search OptimizationDetermine criteria during structural design, final check before deploymentTo avoid delaying decisions impacting URL and language structures
Mobile VerificationIteratively check starting from the representative page stageTo check long titles, images, and button layouts early
AutomationExecute on a small scale after setting manual operations rulesTo prevent unnecessarily overwriting reviewed content

6. Division of Labor Between Marketer and AI#

Division of Roles Between Marketer and Codex
AreaMy ResponsibilitiesCodex's Assistance
DirectionDetermine site objectives and desired designImplementation aligned with chosen direction
ContentReview service messaging, case studies, and display orderOrganize content structure and support translation
FunctionalityExplain required elements and placementWrite shortcodes, templates, and styles
TechnologyCommunicate requirements and operational criteria to checkCheck configurations, build, and fix errors
ReviewMake final judgments based on screens and copyReflect revisions and repeat verification

Even with AI assisting in implementation, I had to verify the factual accuracy of the company’s messaging and content. Clearly explaining desired outcomes and review criteria was my role.

7. Precision Prompting Reduced Errors#

Actual requests did not end with one or two short instruction sentences. I first explained the role and objectives, then organized the project environment, file paths, step-by-step requirements, forbidden modifications, validation methods, and output formats.

In particular, I paid close attention to refining words and conditions used within prompts so they did not conflict with one another. Referring to the same target by different names or mixing instructions to preserve versus modify could lead to unwanted results.

Components of Precise Requests and Error Prevention Objectives
Request ComponentWhat Was ClarifiedErrors Aimed to Be Reduced
Role and ObjectivesObjectives of the work such as Hugo development, localization, and technical SEOConfusion in work direction
Environment and LocationsTheme name, configuration files, content paths, reference pagesModifications to unintended files or structures
Terminology and ValuesCompany name, brand name, language paths, exact contact URLNotation inconsistencies and broken links
Scope and ExceptionsKorean/English targets, reviewed files, prohibited modificationsOmissions or unnecessary overwriting
Implementation ConditionsShortcode parameters, default values, display locations, link attributesUnintended behaviors
Validation and OutputBuilds, page-by-page checks, modified files, and result reportsEnding reviews based solely on explanations that it was implemented

For instance, in multilingual content work, I specified both the rule that Korean serves as the translation standard and the exception that reviewed service files must not be modified. For CTA work, I clearly distinguished the location right below results, the Korean/English application scope, default URLs, and new tab attributes.

I felt that this precision in requests contributed significantly to reducing errors. Reference screens and screenshots supplemented explanations, while results were confirmed through previews and validation reports.

8. Completed Work and Next Steps#

Current Build Status and Next Tasks
StatusContent
Build and DeploymentBuilt and deployed Hugo-based Korean and English website
Content OperationsEstablished detail page formats, reusable CTAs, and authoring guides
Technical ChecksOrganized search-related settings, analytics tools, images, and mobile icons
Next StepsConfigure prepared translation sync scripts and validate live API execution

By clarifying your plans, completing items one by one according to step-by-step completion criteria, and optimizing, you can become a happy builder with Codex. Start from the big picture, and finally take care of small details and invisible technical settings.

Author

정상원
Marketing Director

Founder and CEO of 247COMPASS. From content marketing to SEO, brand content strategy and media planning, he helps brands understand and strengthen their connections with customers.

Next step

Let’s talk about your next direction

Connect with 247COMPASS for search, content and media strategy.