💡 Theme documentation

Get Theme up and running, step by step.

The following guide will walk you through installing the theme from scratch until your site looks exactly like the demo.

yoursite.com
Theme demo homepage
Before you begin

A quick checklist

Having these ready saves you from stopping halfway through. If you're missing something, none of it takes long to sort out.

  • A working WordPress siteA fresh install is ideal, especially if you plan to import the demo.
  • Admin accessYou'll need an Administrator account to install themes and plugins.
  • The theme filealt-theme.zip, inside your download package.
  • A stable internet connectionPlugins and demo content are downloaded while you work.
i

Don't unzip the alt-theme.zip

WordPress wants the .zip file exactly as it is. If your download came as one big package, unzip that outer package once and look for alt-theme.zip within it.

Chapter 01

Install the theme

There are two ways to get Theme onto your site. The dashboard upload is the easiest and works for most people. FTP is there as a backup if your host limits upload sizes.

Recommended

Dashboard upload

No extra tools needed. Everything happens inside WordPress.

Alternative

FTP / File Manager

Handy if you hit an upload size limit or your host blocks theme uploads.

Option A — Upload from the dashboard

  1. Open the theme installer

    Log in to your WordPress dashboard and go to Appearance → Themes, then click Add New Theme at the top of the page.

    Appearance → Themes → Add New Theme
    The Add New Theme button sits beside the page title.
  2. Upload the zip file

    Click Upload Theme, then Choose File, and select alt-theme.zip from your computer. Press Install Now and give WordPress a moment to unpack it.

    Upload Theme form with alt-theme.zip selected
  3. Activate Theme

    When you see "Theme installed successfully", click Activate. You're now running Theme. The site won't look like the demo just yet — that comes in chapter three.

    Theme installed successfully · Activate button
    ✦

    You'll see a new "Theme Options" menu

    Once Theme is active, a Theme Options item appears in the dashboard sidebar. You'll use it later to fine-tune your site. For now, just carry on to the plugins.

Option B — Upload via FTP

  1. Extract the theme on your computer

    Unzip alt-theme.zip. You'll get a single folder called alt-theme.

  2. Upload the folder

    Connect to your server with an FTP client (or your host's File Manager) and drop the alt-theme folder into /wp-content/themes/.

  3. Activate it from WordPress

    Go to Appearance → Themes, find Theme in the list, and click Activate.

Chapter 02

Install the required plugins

Theme leans on a few plugins for page building, forms and demo import. You don't need to hunt for them. The theme lists everything and installs it for you.

What gets installed

PluginStatusWhat it does
ElementorRequiredThe page builder behind every Theme layout.
AltDesain CoreRequiredAdds the custom Elementor widgets and the Header, Footer and other builders that Theme relies on.
Contact Form 7RequiredPowers the contact and newsletter forms.
One Click Demo ImportRequiredHandles the one-click demo import in chapter three.

Installing them

  1. Follow the notice after activation

    Right after you activate Theme, a banner appears at the top of your dashboard asking you to install the required plugins. Click Begin installing plugins. You can also reach the same page any time from Appearance → Install Plugins.

    Dashboard notice ·
  2. Select every plugin and install

    Tick the checkbox at the top of the list to select all four plugins. Choose Install from the Bulk Actions menu, then click Apply. WordPress downloads each one in turn. Please leave the page open until it finishes.

    Install Required Plugins table with bulk action
  3. Activate them

    Installing isn't the same as activating, so this part is manual. Return to Appearance → Install Plugins, select all again, choose Activate from Bulk Actions and apply.

    When the list shows every plugin as Active, you're done.

    All plugins showing
!

If AltDesain Core fails to download

Install it by hand instead. Go to Plugins → Add New Plugin → Upload Plugin, choose alt-desain-core.zip, click Install Now and then Activate Plugin. Make sure Elementor is active first.

Chapter 03

Import the demo content

This is the fun part. One click brings in the pages, posts, menus, widgets and theme settings from the live Theme demo, so you can start editing real layouts instead of a blank page.

!

Best on a fresh site

The import adds content to your site and sets the homepage and menus. If you already have pages you care about, take a backup first, or try the demo on a test install.

Running the import

  1. Make sure the plugins are active

    Elementor, AltDesain Core, Contact Form 7 and One Click Demo Import should all be active. If you finished chapter two, you're already set.

  2. Open the import screen

    Go to Appearance → Import Demo Data. You'll see the Theme Demo card with a preview image.

    Import Demo Data screen · Theme Demo card
  3. Click Import

    Press Import on the Theme Demo card and confirm when WordPress asks. A progress screen appears while the content, widgets and settings are brought in.

    !

    Keep this tab open

    Please don't close or refresh the page until the import says it's finished. Depending on your hosting, it can take a few minutes.

    Import in progress
  4. Visit your site

    When you see "All done. Have fun!", open your homepage. It should now match the demo. Images can take a little longer to appear while they finish downloading.

    Import finished ·

What you'll get

  • Demo pages and postsIncluding the Home page, ready to edit with Elementor.
  • Homepage set for youThe page called "Home" becomes your static front page automatically.
  • Menus assigned"Main Menu" and "Footer Menu" are created and attached to their locations.
  • Widgets and theme settingsThe same sidebar widgets and customizer options used in the demo.
✦

Demo photos are for preview only

Swap the demo images and text for your own before you go live.

Chapter 04

Customize your site

Everything below lives in the Theme Options menu of your dashboard. Builders let you replace parts of the theme with your own Elementor designs.

Theme Options

Open Theme Options in the dashboard sidebar. Change the settings you need and press Save Settings at the bottom.

Theme Options page
SettingWhat it does
Maintenance ModeTick to lock the site for visitors. Logged-in admins still see the site normally. Pick one of 6 maintenance page designs from the thumbnails below it.
Change LogoUpload your logo. Not shown when a Header Builder header is published.
Page Width (px)Width of the default layout. Match it to your Elementor Boxed width. Default 1140, min 800, max 1920.
Full Width ModeMatch Elementor's Full Width layout. Ignores Page Width.
Blog LayoutRight sidebar, left sidebar or no sidebar. Works on the default (non-Elementor) templates only.
Sticky HeaderYes/No: keep the header fixed while scrolling. Sticky Header Background Color sets the color it fades to after scrolling (leave empty for no change).
Primary, Secondary & Background ColorPrimary and Secondary only affect default templates. Background Color applies to every Elementor page. Colors support opacity.
Heading Font & Text FontChoose fonts for H1–H6 and body text from the theme, WordPress or Google sources. Elementor can still override them per widget.
Google Fonts API KeyOptional. Add a key to unlock the full Google Fonts list.
Cursor EffectNone or Cursor Effect 1–6, shown on Elementor pages.
Back to TopNone, Box, Curved or Circle. Also set its color and position (Right Bottom or Left Bottom).
Glass Blur EffectBlurred glass strip at the bottom of the screen. Set height for desktop, tablet and mobile (20–500 px, default 80), or disable it on mobile.
SVG PreloaderPaste SVG code to show a preloader, plus its background color. Leave empty to turn the preloader off.
Footer TextText in the default footer. Ignored when a Footer Builder footer is published.
✦

Hover the "?" icons

Most settings have a small "?" tooltip next to the label with extra hints.

Header Builder

Replace the default header with your own Elementor design. Menus, logos, buttons and a sticky bar are all built visually.

  1. Open the builder

    In the dashboard go to Theme Options → Header Builder and click Add New.

  2. Name it and publish

    Give it any title you like (it is only for you) and click Publish.

  3. Design it with Elementor

    Click Edit with Elementor and build your header using any Elementor or AltDesain Core widget. Click Update when done.

    ✦

    Show your menu

    Drop the Nav Menu widget (AltDesain Core) in and choose a menu. The mobile hamburger menu is controlled in the widget's Mobile Menu Settings.

    Header Builder · Elementor editor
i

Only one header is used

If you publish several headers, the one with the highest Order value (Page Attributes box) is displayed. Set the order or move the others to Draft. With no header published, the default header and Theme Options logo are used.

Works the same way as the Header Builder and replaces the default footer.

  1. Open the builder

    In the dashboard go to Theme Options → Footer Builder and click Add New.

  2. Name it and publish

    Give it any title you like (it is only for you) and click Publish.

  3. Design it with Elementor

    Click Edit with Elementor and build your footer using any Elementor or AltDesain Core widget. Click Update when done.

    Footer Builder · Elementor editor
i

Footer Text is switched off

When a footer is published, the Footer Text setting in Theme Options is ignored. Again, the highest Order wins when more than one exists.

Controls the title / breadcrumb band shown under the header on inner pages. Without a custom one, the theme shows the page title and a trail (Home » Page).

  1. Open the builder

    In the dashboard go to Theme Options → Breadcrumb Builder and click Add New.

  2. Name it and publish

    Give it any title you like (it is only for you) and click Publish.

  3. Design it with Elementor

    Click Edit with Elementor and build the breadcrumb area using any Elementor or AltDesain Core widget. Click Update when done.

    Use Dynamic Tags (see chapter six), such as Page Title (Auto) or Archive Title, so one design fits every page.

    Breadcrumb Builder · Elementor editor

404, Search, Archive & Single Page Builders

These four builders sit in the same Theme Options submenu and share the steps above. Pick the one you need:

BuilderReplacesExtra step
404 Page BuilderThe "page not found" screen.None. The highest Order is used.
Search Result BuilderThe search results page.None.
Archive Page BuilderArchive templates.In the side box Select Target choose: Blog Archive, Category, Date, Author, or an archive of one of your Custom Post Types (and its category archive).
Single Page BuilderSingle post / page templates.In Select Target choose Blog Post, Page or one of your Custom Post Types.
Archive Page Builder · Select Target box
✦

Tip

Build a single template once, then fill it with Dynamic Tags (title, featured image, custom fields) so it works for every post.

Mega Menu Builder

  1. Create the menu first

    Build your normal menu in Appearance → Menus.

  2. Add a mega menu

    Go to Theme Options → Mega Menu Builder, click Add Mega Menu, and design the dropdown in Elementor.

  3. Select the target

    In the side box Select Target, pick the menu item this design should replace on hover, then Publish.

    Mega Menu · Select Target box
i

Requires the Nav Menu widget

Mega menus appear through the Nav Menu widget, so use it in your header.

Custom Post Type

Create your own content types (Portfolio, Services, Events…) without code, then show them with the Blog List, Project Slider and other widgets.

  1. Add a new type

    Go to Theme Options → Custom Post Type and click Add New Custom Post Type. The title becomes the type's name and URL (first 20 characters).

  2. Configure it

    In Custom Post Type Configuration: choose a Menu Icon, tick Format Supports (Title, Editor, Featured Image) and optionally Enable Category.

  3. Add custom fields

    Click Add New Field and fill in Field Name, Label, Type and, where needed, Options. Drag to sort. Types: Text, Date, Number, Textarea, Select, Checkbox, Radio, Image, Gallery, Post Relation, Post Object, Taxonomy.

    For Select and Radio, put choices comma separated (e.g. Yes,No). For Post Relation, list allowed post type slugs (e.g. post,project).

    Custom Post Type configuration
  4. Publish and use it

    Click Publish. A new menu appears in the dashboard where you add entries with the extra fields. Display them in Elementor with the Custom Field dynamic tags, or give them templates in the Single and Archive builders.

!

If the CPT post page does not appear on the frontend

Go to Settings → Permalinks and press Save Changes once to refresh the links.

Chapter 05

Create a contact form

Contact Form 7 is installed with the theme. Here is how to build a form and place it with the dedicated widget.

  1. Create the form

    Go to Contact → Add New Contact Form, name it, and edit the Form tab. A ready-to-use template:

    <label>Your name
      [text* your-name autocomplete:name] </label>
    <label>Your email
      [email* your-email autocomplete:email] </label>
    <label>Subject
      [text your-subject] </label>
    <label>Message
      [textarea your-message] </label>
    [submit "Send message"]

    A star (*) makes a field required.

    Contact Form 7 · Form tab
  2. Set up the email

    Open the Mail tab. Put your address in To, keep [your-name] and [your-email] in the body, and set Reply-To via Reply-To: [your-email] in Additional Headers.

    Contact Form 7 · Mail tab
  3. Edit the messages

    The Messages tab holds the success and error texts. Click Save.

  4. Add the form to a page

    Edit a page with Elementor, drag in the Contact Form 7 widget from the AltDesain Core group, and pick your form in Content → Form. You can also paste the shortcode, e.g. [contact-form-7 id="123" title="Contact"], into a Shortcode widget.

    Contact Form 7 widget · Form selector
  5. Style it

    The widget's Style tab styles Form Container, Input Fields, Labels, Checkbox & Radio, Submit Button, Inline Layout, Loading Spinner, Response Messages and Field Validation Tip.

!

Emails not arriving?

Many hosts block PHP mail. Install an SMTP plugin and connect your mailbox. Also check the spam folder.

Chapter 06

Widgets, modules & conditions

A map of the places in Elementor where AltDesain Core adds its options. No need to memorize it, just know where to look.

Where to find the widgets

Open any page with Edit with Elementor. In the left panel, search by name or scroll to the AltDesain Core group and drag a widget onto the page. Every widget has two tabs: Content (what it shows) and Style (how it looks). Hidden options live inside the collapsible sections listed below, so open each section to discover them.

Elementor panel · AltDesain Core group
WidgetSections to open
Album GalleryContent: Layout, Albums, Cover Image, Card Content, Hover Effect, Lightbox · Style: Cover, Title, Filter Tabs…
Animated ButtonContent: Button Content · Style: Button, Arrow, Animation
Animated TextContent, Style
Blog CarouselContent: Query, Carousel Settings, Item Layout · Style: Navigation Arrows / Dots
Blog ListContent: Query, Layout, Pagination · Style: Item Box, Pagination / Load More
Circle TextCircle Text, Rotation, Center
Contact Form 7Content: Form · Style: all form parts
Cursor Image PreviewContent: General, Preview Behavior · Style: Row, Preview Image
Divided ShowcaseContent: Slides, Settings · Style: Content / Image Column, Counter, Arrows, Dots
Flip BoxContent: Interaction, Layout · Style: Box
Graph BarsContent: Data, Settings · Style: Grid & Axis, Bars, Line & Area, Tooltip
Horizontal Scrolling GalleryContent: Gallery, Scroll Behavior · Style: Items, Caption, Progress Bar
Image HotspotContent: Image, Hotspots, Settings · Style: Marker, Tooltip
Item ShowcaseContent: Item Image, Items, Settings · Style: Layout, Icon / Number
Nav MenuContent: Menu Settings, Mobile Menu Settings · Style: Submenu Panel, Hamburger Menu. Shows Mega Menus.
Normal ButtonContent: Button Content, Layout & Type, Icon
Off CanvasContent: Trigger Button, Canvas Content, Canvas Settings, Close Button · Style: Canvas Panel, Overlay
Overlap SliderContent: Slides, Slider, Navigation · Style: Default Card, Arrows
Pinned OverscrollContent: Panels, Layout & Animation
Pricing TableContent: Layout, Ribbon / Badge, Price, Features List, Button · Style: Featured Card
Process StepsContent: General, Stages, Process Line · Style: Marker
Project SliderContent: Slides, Settings · Style: Info Panel, Counter, Arrows, Dots
Scroll Highlight TextContent: Text, Scroll Animation · Style: Colors
Scrubbed Bento GalleryContent: Gallery, Scroll Behavior
TeamContent: General, Team Members, Hover Info · Style: Social Icons
Testimonials ListContent: Layout, Testimonials, Quote Icon, Author Info
Text MarqueeMarquee Items, Style
Textual ShowcaseContent: Showcase Items, Image Hover Behavior
Vertical TickerContent: Ticker Items, Animation · Style: Fade Effect
Video ButtonContent: Video, Display & Button, Video Options, Player Controls · Style: Popup, Player

Modules (extra Elementor controls)

The plugin adds extra controls to every Section, Container and Widget. Select an element, then open the tab shown below. Items marked with a check (✓) come from AltDesain Core.

ModuleWhere to find itWhat it offers
Sticky ✓Advanced → Motion EffectsStick an element while scrolling. Choose the devices (Sticky On) and the Sticky Offset.
Mouse Effect ✓Advanced → Motion EffectsMove, 3D Tilt or Liquid. Set Intensity, Speed; for Liquid add an image and Strength.
Scrolling Effects ✓Advanced → Motion EffectsAnimate elements as the page scrolls. Choose the effect and Effect Speed.
Grid Background ✓Style → Grid Background (Containers / Sections, below Shape Divider)Draws a grid pattern behind the element. Adjust Grid Gap.
Custom CSS ✓Advanced → Custom CSSWrite CSS that applies only to this element.
Attributes ✓Advanced → AttributesAdd custom HTML attributes (data, aria, id).
Display Conditions ✓Advanced → Display ConditionsShow or hide an element by rules. See below.
i

Motion Effects order

Sticky, Mouse Effect and Scrolling Effects are stacked one after another at the top of the Motion Effects section.

Dynamic Tags

Dynamic Tags fill a field automatically from the current page. Click the small Dynamic (stack) icon at the right of any text, link, image or gallery field, then choose a tag.

GroupTags
Post ✓Post Title, Page Title (Auto), Post Excerpt, Post Content, Post URL, Post ID, Post Date, Featured Image, Post Custom Field, Post Categories / Terms, Post Category URL
Site ✓Site Title, Site Tagline, Site URL, Site Logo
Author ✓Author Name, Author Bio, Author Posts URL, Author Profile Picture
Archive ✓Archive Title, Archive Description, Archive URL
Custom Field ✓Fields from your Custom Post Types: text, image, gallery, and Post Relation / Post Object fields
Dynamic Tags · select list

Display Conditions

  1. Open the section

    Select an element, open Advanced → Display Conditions.

  2. Choose the action

    Action: Show or Hide. Display When: All Conditions Are Met or Any Condition Is Met.

  3. Add conditions

    Click Add Item under Set Condition, pick a type and its value (Is / Is Not).

    Display Conditions · Set Condition
GroupCondition types
VisitorUser: Logged In, User: Logged Out, User: Role, Device, Browser, Operating System, Referrer URL, URL Query String
TimeDate Range, Day of the Week, Time of Day
ContentAuthor, Post Type, Specific Post/Page ID, Category / Taxonomy Term, Static Page (Homepage, Blog Page, 404, Search Results)
✦

No conditions = always visible

An element with an empty list is shown normally. Display Conditions only appear when Elementor Pro is not installed.

Chapter 07

Multilanguage support

Translate the theme and plugin interface into your own language, and prepare your site for several languages.

  1. Set the site language

    Go to Settings → General and choose Site Language. Install and activate Loco Translate from the plugin directory.

  2. Translate Theme and plugin

    Open Loco Translate → Themes and pick the theme, then click New language. Do the same in Plugins for AltDesain Core. Translate the strings and press Save. Both ship with a translation template (.pot) in their languages folder. You can also use Poedit and upload the .mo file there.

    Loco Translate · translating strings
  3. Translate your content

    Pages, menus and Elementor designs are your own content, so write them in the language you need. For a multilingual site use a translation plugin of your choice (Polylang, WPML, TranslatePress…).

!

Good to know

The theme and plugin are translation-ready, but no multilingual plugin is bundled or built in. The Header and Footer builders show one design for all languages (highest Order), so translate the texts inside them with your translation plugin.

Troubleshooting

If something doesn't look right

These are the questions that come up most often. Most fixes take under a minute.

The theme upload fails with "link has expired" or a size error

That's your host's upload limit talking. Either ask your host to raise upload_max_filesize and post_max_size, or use the FTP method from chapter one, which skips the limit entirely.

I don't see the "Install Plugins" notice

You may have dismissed it. Open it directly from Appearance → Install Plugins. If the menu isn't there, confirm Theme is the active theme.

The "Import Demo Data" menu is missing

It belongs to the One Click Demo Import plugin. Check that it is installed and active in Plugins → Installed Plugins.

The import stalls or ends with an error

This usually means the server timed out. Ask your host to raise max_execution_time and memory_limit (a generous value such as 300 seconds and 256 MB is a safe request), then run the import again. Because the demo files are downloaded from our server, also check that your host isn't blocking outgoing connections.

The pages look unstyled or Elementor widgets are missing

Confirm that both Elementor and AltDesain Core are active. The custom widgets and builders only load when both are running.

My header or footer design does not show

Check that it is Published and that it has the highest Order among builders of the same type. Then clear your cache.

Custom Post Type pages show "Not Found"

Open Settings → Permalinks and click Save Changes once.

Display Conditions section is missing

It is only added when Elementor Pro is not active, because Elementor Pro has its own version.

Give us Positive Reviews.

Help us provide positive reviews by giving us a decent rating, your review means a lot to us. Visit AltDesain Studio to see other cool themes.

Visit AltDesain Studio