All guides
User

Captions

Prepare, review or publish content to selected destinations.

Step-by-step guide

Before you start

Use the account and workspace that own the records. This page does not include administrator configuration forms.

Open this feature

Open /portal/captions on your application domain. The tasks below name the controls to use after opening the page.

Steps

Use the workspace that should own the caption. The caption library must be enabled and your role must allow creating posts.

Save a reusable caption

  1. Open Captions and select Create caption.
  2. Enter Test product launch in Caption name. Choose the intended Status: Active, Draft or Archived.
  3. In Your caption, enter the text to reuse, for example Our new product is available today. Visit the product page for details.
  4. Add optional comma-separated Tags such as launch, product. Open Add internal notes only if you need a private reminder.
  5. Select Save caption. Find the caption in the library and use Preview to check the saved text.

Reuse or edit a caption

  1. Use Copy on the intended caption, then paste the text into the post you are composing. Check the text after pasting.
  2. If copying fails, open Preview and select the text manually.
  3. To change the stored caption, use Edit, change the fields and select Save changes. Check the saved preview again.

Fields shown in the interface

Field or settingWhat to enter or choose
Caption nameRequired, up to 120 characters. It identifies the library entry.
StatusActive, Draft or Archived. This is a caption-library state, not a published-post state.
Your captionRequired, up to 10,000 characters. The destination social network can impose a smaller limit when publishing.
TagsOptional comma-separated tags, up to 1,000 characters before processing.
NotesOptional internal notes, up to 2,000 characters.

Check the result

  • Preview contains the stored caption text.
  • Saving or copying a caption does not publish it to a social network.

Problems and validation

ProblemWhat to do
Caption does not appearClear the library filters and check its status and workspace.
Copy does not workUse Preview to select the text manually; clipboard access depends on the browser.
A post rejects the copied captionCheck the selected network’s post requirements and shorten or adapt the text in the post editor.

Technical reference

Sources for these task instructions
Role-scoped source references

Pinned commit: 1d0944d30f606782c9abf5b878224cdd3cd09b99

Source-only route information
MethodSource-default route
GET/portal/captions
Unmapped fields — not user instructions

These fields belong to this role’s source handler, but their screen labels were not confirmed.

Source keyHandler
namemodules/AppCaptions/Livewire/CaptionWorkspace.php
sourceTypemodules/AppCaptions/Livewire/CaptionWorkspace.php
captionStatusmodules/AppCaptions/Livewire/CaptionWorkspace.php
contentmodules/AppCaptions/Livewire/CaptionWorkspace.php
notesmodules/AppCaptions/Livewire/CaptionWorkspace.php
tagsmodules/AppCaptions/Livewire/CaptionWorkspace.php