Usage Guide

Learn how to create beautiful Open Graph images with ogimagex

Getting Started

ogimagex offers three different editing modes to suit your needs, from simple template-based editing to complete creative freedom.

Basic Mode

Perfect for quick edits using predefined templates with form fields.

Advanced Mode

Canvas-based editor with drag-and-drop elements for more control.

Free Form Mode

Complete creative freedom with professional-grade editing tools.

Basic Mode

Basic mode is the fastest way to create OG images using our professionally designed templates.

Step 1: Choose a Template

Browse our template gallery and click on a template that fits your needs. Each template is designed for specific use cases like blog posts, quotes, statistics, and more.

Step 2: Customize Content

Use the form fields in the sidebar to customize the template. You can change text, colors, fonts, and other parameters. The preview updates in real-time as you make changes.

Step 3: Adjust Size

Use the size controls to adjust the image dimensions. The default 1200×630 is perfect for most social media platforms, but you can customize it as needed.

Step 4: Download

Click the download button to save your image. You can choose between PNG and SVG formats depending on your needs.

Advanced Mode

Advanced mode gives you more control with a canvas-based editor where you can add and arrange elements.

Adding Elements

Use the toolbar to add text, images, and shapes to your canvas. Each element can be selected, moved, and styled independently.

Drag and Drop

Click and drag elements to reposition them on the canvas. Elements snap to the canvas edges for easy alignment.

Styling Elements

Select an element to access its styling options in the sidebar. You can change colors, fonts, sizes, and other properties.

Deleting Elements

Select an element and press the Delete key or click the trash icon to remove it from the canvas.

Free Form Mode

Free Form mode is our most powerful editing experience, powered by Fabric.js for professional-grade design capabilities.

Canvas Tools

Access a full suite of design tools including text, shapes (rectangle, circle, triangle, line, star, heart), images, and icons from the Lucide library.

Layer Management

Use the Layers panel to manage element stacking order. You can move elements up, down, to the front, or to the back. Toggle visibility and delete layers as needed.

Alignment Tools

Perfectly align elements using smart alignment tools. Align left, center, right, top, middle, or bottom. Distribute elements evenly with distribution tools.

Grid and Snap

Enable the grid overlay for visual guidance. Turn on snap-to-grid to automatically align elements to the grid for precise positioning. Adjust grid size to your preference.

Keyboard Shortcuts

Speed up your workflow with keyboard shortcuts: Ctrl+Z (undo), Ctrl+Y (redo), Ctrl+C (copy), Ctrl+V (paste), Ctrl+X (cut), Ctrl+D (duplicate), Ctrl+A (select all), Delete (remove), Arrow keys (move).

Zoom and Pan

Use the zoom controls in the bottom-left corner to zoom in and out of the canvas. This is helpful for detailed editing or viewing the overall composition.

Save and Load Templates

Save your current canvas as a template to local storage for later use. Load saved templates to continue editing or use them as starting points for new designs.

Drag and Drop Images

Simply drag and drop image files from your computer directly onto the canvas to add them to your design. Images are automatically scaled to fit.

Enhanced Color Picker

Choose from a color picker with 24 preset colors for quick selection, or use the full color picker for custom colors. The preset palette includes popular design colors.

Google Fonts Integration

Access 20+ Google Fonts in addition to system fonts. Preview fonts in real-time and choose the perfect typography for your design.

Icon Library

Add icons from the Lucide icon library directly to your canvas. Icons are added as text elements that you can style and position like any other element.

Multiple Export Formats

Export your designs in PNG, JPG, WebP, or SVG formats. Choose the format that best suits your use case - PNG for social media, SVG for scalability, JPG for compatibility, WebP for modern web.

Exporting Images

Format Comparison

FormatBest ForTransparency
PNGSocial media, web useYes
JPGMaximum compatibilityNo
WebPModern web, smaller file sizeYes
SVGPrint, editing, scalabilityYes

Recommended Sizes

  • Open Graph: 1200×630 (default)
  • Twitter Card: 1200×630
  • LinkedIn: 1200×627
  • Facebook: 1200×630
  • Instagram: 1080×1080 (square) or 1080×1350 (portrait)

Using the API

Generate images programmatically using our REST API. Perfect for automation, CMS integration, or dynamic image generation.

Basic API Call

GET https://ogimagex.xyz/api/public/og/showcase?title=Hello+World&subtitle=My+OG+Image&url=example.com&accent=%237c3aed

With Custom Size

GET https://ogimagex.xyz/api/public/og/blog?title=Blog+Post&author=John+Doe&w=800&h=600&format=png

For complete API documentation, see our API Documentation page.

Design Tips

Keep It Simple

Focus on one main message or visual. Too much text or too many elements can make your image cluttered and hard to read.

Use High Contrast

Ensure your text is readable against the background. Dark text on light backgrounds or light text on dark backgrounds works best.

Choose Readable Fonts

Use clear, readable fonts at appropriate sizes. Sans-serif fonts like Inter, Arial, or Roboto are great for digital images.

Brand Consistency

Use your brand colors and fonts consistently across all your OG images to build brand recognition.

Test on Mobile

Many users view content on mobile devices. Ensure your images look good at smaller sizes and on different screen sizes.

Include CTAs

Add a call-to-action when appropriate. "Read more", "Learn more", or "Get started" can increase engagement.

Need More Help?

Check out our FAQ page for common questions or our API documentation for technical details.